agentify sess

A durable save file for provider work.

Sessions wrap provider runs with state on disk: a manifest, a fitted context, run history, and bootstrap markdown. sess dispatches at src/main.js with subcommands run, resume, fork, and list.

subcommands next: context
state root .agentify/session/<id>/ module src/core/session.js alias agentify session
subcommands

Four subcommands cover the loop.

Each subcommand is dispatched in src/main.js (:883–:928) and implemented in src/core/session.js.

start

sess run

Dispatch: src/main.js:928.

Flags: --session <id>, --from <id>, --provider, --name <string>, --root, --context-mode, --caveman, --with-context, --interactive, --timeout, --fail-on-stale, --skip-refresh.

Creates .agentify/session/<new-id>/ with manifest and fitted context, then launches the provider.

agentify sess run --provider codex --name "payments-v2"
continue

sess resume

Dispatch: src/main.js:917 · resumeSession(root, sessionId).

Flags: --session <id>, --provider, --root; positional task tokens after flags are appended to the resume prompt.

Reads session-manifest.json and context.json, appends to run history.

agentify sess resume --session <id> "finish the tests"
branch

sess fork

Dispatch: src/main.js:897 · forkSession(root, config, { from, provider, name }).

Flags: --from <id>, --provider, --name <string>, --root; positional task supported.

Creates a child session with a new id; carries forward checklist and run history from the parent.

agentify sess fork --from <id> --name "payments-v2-review"
inspect

sess list

Dispatch: src/main.js:883 · listSessions(root).

Flags: --root, --json.

Prints session id, provider, and creation time. With --json returns the full manifest list.

agentify sess list --json
artifacts

Files under .agentify/session/<id>/

Names below are the exact filenames written by src/core/session.js and the related session-memory and handoff modules.

session-manifest.json Session id, parent / fork id, provider, name, created_at, index snapshot, cache refs.
context.json Fitted context: module ids, checklist summary, run history, rolling summary, artifact refs.
checklist.json Structured task checklist carried from parent session on fork.
bootstrap.md Markdown launch brief generated from the bounded context.
transcript.md Run transcript used by automatic session memory and recall.
memory-context.md Memory excerpt attached to the launch when prior memory exists.
launches.jsonl Provider launch records with command, capture mode, prompt metadata.
turns.jsonl Per-turn structured records for replay and managed-context estimates.
context-events.jsonl Context fetch and routing events emitted during the session workflow.
context-facts.json / .md Compacted facts written when agentify context compact runs.
handoff.json / handoff.md Cross-agent bundle written by agentify handoff --session <id>.