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
grixel rehome <depot-id> # adopt a server that replaced the one this checkout came fromrehome is for one situation: your administrator replaced
the server and your working copy is being refused. Get the id from
grixel info run against the new server. See Troubleshooting.
#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 edit 'art/**' # claim every lock-required file matching a pattern
grixel edit -modified # claim the lock-required files you have already changed
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 private ls -all # admin: every private folder with its owner
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#Checkpoints
Private, local save-points of your working copy. Restoring never destroys work — it snapshots the current state first, so a restore is always reversible.
grixel checkpoint -m "before the risky refactor" # snapshot now (alias: grixel stash)
grixel checkpoint list # your save-points, newest first
grixel checkpoint show <id> # what a checkpoint captured
grixel checkpoint diff <id> # compare it to the working copy
grixel checkpoint restore <id> # roll back (reversible)#Agent credentials and workspaces
Give an AI agent its own limited, expiring credential and a throwaway checkout to work in, instead of handing over your own login.
grixel token delegate --tool <name> --lane <path> [--ttl <duration>] # mint an agent credential
grixel token list # your delegated credentials
grixel token revoke <id> # kill one immediately
grixel workspace create --ephemeral [--as-agent] [-path <glob>] <ref> # a disposable, isolated checkout
grixel workspace list # your workspaces
grixel workspace done <id> # finish and clean one up
grixel agent-setup --claude-code-worktrees # wire Claude Code worktrees to grixel workspaces--lane limits where the credential may write;
--ttl bounds how long it lives.
workspace create --as-agent mints one credential per
workspace automatically.
#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