CLI

Install:

bun add -g gittrix

The current CLI uses a local durable adapter pointed at process.cwd() and a local ephemeral adapter under ~/.gittrix/sessions.

It is not currently wired for GitHub or Cloudflare configuration.

Commands

gittrix session start "<task>" <durable-path> [branch]
gittrix s start "<task>" <durable-path> [branch]

gittrix session list [active|promoted|discarded|expired|all]
gittrix session diff <session-id>
gittrix session log <session-id>
gittrix session evict <session-id>

gittrix promote <session-id> [--files=a,b] [-m "msg"]
gittrix p <session-id> [--files=a,b] [-m "msg"]

gittrix session log <session-id> exists, but current core session.log() returns an empty array.

Flags

--json, -j
--task, -t
--durable, -d
--branch, -b
--message, -m
--files, -f
--strategy, -s

JSON mode

Use --json or -j.

Success:

{ "ok": true, "data": {} }

Error:

{ "ok": false, "error": { "code": "UNKNOWN", "message": "..." } }

For GittrixError, the stable error code is returned.