# Gravity CLI 0.1.0: Gravity on the command line

Canonical: https://www.gravitynotes.app/changelog/cli/0.1.0

1 October 2026

- Read and write your Mac's Gravity notes from Terminal with the `gravity` command, for scripts and AI agents.
- Commands cover listing, searching, adding, appending to, editing, rescuing, archiving and trashing notes, plus tags, stats, export and import.
- Add `--json` to any command for JSON output. Destructive commands ask for `--yes` and support `--dry-run`.
- Changes you make sync to iCloud through the Mac app.
- `gravity doctor` checks your database, `gravity sync status` shows what's waiting to sync, and `gravity agent` prints a guide for AI agents.
