For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /reference/cli.md.

Command reference

Every command of the korbo program. korbo with no arguments prints the same list.

Signing in

CommandWhat it does
korbo sign-in <server>Opens the hub's sign-in page in your browser. korbo keeps tokens, never the password.
korbo sign-in <server> --no-browserThe same, but only prints the address to open.
korbo sign-in <server> <email>Signs in without a browser. The password is read from KORBO_PASSWORD, or typed.

Tracking and syncing

CommandWhat it does
korbo track <file or folder> <entry> --kind <kind> [--project <key>]... [--label <name>]... [--everywhere]Keeps a file in step with the entry <entry>. For a folder, every Markdown file under it is tracked as <entry>/<path inside the folder>, including files added later.
korbo untrack <file, folder or entry>Stops keeping it in step. The file and the entry are left as they are.
korbo syncUploads what changed here and downloads what changed on the hub. Exit code 2 means a conflict.
korbo statusLists the tracked folders and files.

Agent hooks

CommandWhat it does
korbo hooksShows which agent programs are on this machine and whether korbo's hooks are set up.
korbo hooks install [<program>]...Writes korbo's hooks into each program found, or only those named: claude-code, codex, antigravity.
korbo hooks remove [<program>]...Takes korbo's hooks out again.
korbo sync --hookA sync for a Claude Code or Codex hook. Always exits 0; prints nothing when nothing changed, otherwise one JSON line with a systemMessage.
korbo sync --hook antigravityThe same, for Antigravity's session-start hook. Always prints a JSON object.
korbo sync --hook antigravity-stopThe same, for Antigravity's stop hook. Always prints {}.

Finding and reading

CommandWhat it does
korbo find <words>... [--project <key>] [--limit <n>]Searches every entry across all projects. Quotes make a phrase, or widens, a leading minus excludes.
korbo show <entry>Prints the current text of one entry.

Access

CommandWhat it does
korbo grantsLists the programs that can use your hub, and when each last got a token.
korbo revoke <client ID or name>Ends one program's access at once. It can ask again on the sign-in page.

Values

  • Kinds: Rule, Instruction, Skill, Memory, Decision, Record, TaskList, Note.
  • Project keys and labels: lowercase letters, digits and single hyphens.
  • State folder: KORBO_HOME, or ~/.korbo when it is not set.