Skip to content

docs: document agent session compact #358

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
codeaholicguy merged 2 commits into from
Oct 10, 2026
Merged

docs: document agent session compact #358

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8633cec
docs: document agent session compact
codeaholicguy Oct 10, 2026
6944cab
docs: point readers to agent sessions for session IDs (technical-writ…
codeaholicguy Oct 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions web/content/docs/8-agent-management.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,17 @@ ai-devkit agent session detail <session-id> --tail 50 --verbose

The detail command supports `--type`, `--tail <n>`, `--full`, `--verbose`, and `--json`.

### Compact a Session

Distill a historical session into a durable continuation artifact — structured facts plus memory candidates — that you can hand to a successor agent or store for later:

```bash
ai-devkit agent session compact --id <session-id>
ai-devkit agent session compact --id <session-id> --format json
```

Find session IDs with `ai-devkit agent sessions`. Compaction is classified by Jev and requires the `TYPESAFE_API_KEY` environment variable. Use `--format markdown` (default) for a readable summary or `--format json` to splice the artifact into another agent's instructions. The built-in [`session-compact`](/docs/7-skills) skill teaches agents to run this workflow themselves at handoff points.

### Open Agent

Focus the terminal window associated with a specific agent.
Expand Down
Loading