From 8633cecf3c856d7f41be8dcc4763ca0962b87d3e Mon Sep 17 00:00:00 2001 From: Hoang Nguyen Date: Sat, 10 Oct 2026 13:14:33 +0000 Subject: [PATCH 1/2] docs: document agent session compact Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- web/content/docs/8-agent-management.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/web/content/docs/8-agent-management.md b/web/content/docs/8-agent-management.md index bf5733906..6b5cbcb0c 100644 --- a/web/content/docs/8-agent-management.md +++ b/web/content/docs/8-agent-management.md @@ -105,6 +105,17 @@ ai-devkit agent session detail --tail 50 --verbose The detail command supports `--type`, `--tail `, `--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 +ai-devkit agent session compact --id --format json +``` + +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. From 6944cab8f72ec24902bdd8cc5c237b4a57770b4a Mon Sep 17 00:00:00 2001 From: Hoang Nguyen Date: Sat, 10 Oct 2026 13:37:03 +0000 Subject: [PATCH 2/2] docs: point readers to agent sessions for session IDs (technical-writer pass) Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- web/content/docs/8-agent-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/content/docs/8-agent-management.md b/web/content/docs/8-agent-management.md index 6b5cbcb0c..8a3b6b632 100644 --- a/web/content/docs/8-agent-management.md +++ b/web/content/docs/8-agent-management.md @@ -114,7 +114,7 @@ ai-devkit agent session compact --id ai-devkit agent session compact --id --format json ``` -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. +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