The grixel commands grouped by what you're doing. Every
command supports -h for its full options
(grixel submit -h), and --json for
machine-readable output.
Flags come before file arguments:
grixel approve -m "lgtm" /path, not
grixel approve /path -m "lgtm".
#Sign in and identity
grixel login -server grpc://host:8090 -token <token> # save your sign-in (once)
grixel whoami # who you are and where you're connected
grixel info # connection details
grixel logout # clear a saved sign-in#Look around
grixel ls /companies/acme/games/seasonal # list a path
grixel cat <ref> <path> # print a file from the server
grixel stat <ref> <path> # how a file is stored (size, pieces)
grixel log # recent history
grixel log -oneline # one line per commit
grixel log -files # ...listing each commit's changed files (A/M/D)
grixel log -author <name> -since <date> # filter history by who / when
grixel show <commit> # files changed in a commit (add -u for text diffs)
grixel status # your working copy: what changed, are you behind
grixel diff # line diff of your edits
grixel diff <older> <newer> # files changed between two commits (add -u for text)
grixel diff /ref-a /ref-b # what differs between two branches
grixel difftool # open your edits in a graphical diff tool#Work in a checkout
grixel init -ref <ref> -m "initial import" # turn the current folder into a new project
grixel init -ref <ref> -m "..." -ignore godot,xcode # ...with ignore presets (combine with commas)
grixel init -ref <ref> -m "..." -n # dry run: preview what would be submitted, upload nothing
grixel init -ref <ref> -m "..." -n -v # dry run, listing every file (not just folders)
grixel ignore init <preset>[,<preset>...] # write .grixelignore presets (run bare to list them)
grixel ignore show <preset>[,<preset>...] # preview what a preset would ignore, without writing
grixel checkout <ref> <dir> # check out an existing project
grixel checkout -path 'art/**' <ref> <dir> # check out only part of a large project
grixel submit -m "message" # save your changes (atomic)
grixel revert <path> # discard local edits to a file
grixel sync # pull in others' changes
grixel resolve --mine <path> # settle a conflict (or --theirs)
grixel mergetool # resolve conflicts in a merge tool
grixel branch <src-ref> <dst-ref> # start a branch
grixel merge <src-ref> # merge a branch into your checkout#Locking (binary files)
grixel edit <path> # claim a file before editing it
grixel locks # see who holds locks
grixel unlock <path> # release your lock#Review and sign-off
grixel review status <path> # approvals on a file
grixel review outstanding # what's awaiting sign-off
grixel approve -m "reason" <path> # sign off (if you're allowed)
grixel review promote <src> <dst> # move approved content to a protected area#Jobs
grixel jobs --mine # your worklist
grixel job spec # available types, statuses, fields
grixel job show <id>
grixel job create -type <t> -anchor <path> -title "..."
grixel job update <id> -status <s>
grixel submit --job <id> -m "..." # link a change to a job#Private space and secrets
grixel private create <name> # a folder only you (and admins) can see
grixel key init # one-time: create your encryption key
grixel secret add <path> # start protecting a file
grixel secret push # upload the encrypted version
grixel secret pull # bring it back on another machine#AI assistants
grixel mcp setup # connect an assistant to this project (read-only)
grixel mcp preview # see exactly what an assistant can read#Attributing AI-assisted changes
When an assistant makes a change, tag the submit so history stays honest:
grixel submit -m "message" --tool <tool> --model <model> --role assisted