vicem_create_baton
Creates a compressed context baton and symbol ledger from your session and git state so work can be handed off to another coding agent without losing intent.
Instructions
Creates a compressed U-Shaped Context Baton (.vicem/BATON.md) and symbol ledger (.vicem/ledger.json) from the current project session and git state. Use at session end or before quota limits to hand off work; do not use to read an existing baton (vicem_read_baton), restore a skeletonized function (vicem_rehydrate), or validate edits (vicem_check_guard). Compresses context by skeletonizing unchanged functions >=12 lines into .vicem/ledger.json while keeping signatures intact. Idempotently overwrites .vicem/BATON.md, .vicem/baton.json, and .vicem/ledger.json after saving a rollback snapshot in .vicem/snapshots/, with secret redaction and zero source file mutations (no auth or rate limits). Parameter semantics: goal overrides auto-extracted session intent in Section 1; targetAgent tailors receiver rules (default "codex"); budgetTokens (500-128000, default 4000) controls skeletonization depth. Returns the generated Markdown baton (isError=false).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "vicem_create_baton"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | Optional explicit engineering goal override for Section 1 (e.g., "Fix JWT refresh race in src/auth.ts"). If omitted, inferred from active session history and git diff. | |
| decisions | No | Optional architectural decisions or hard constraints to persist in .vicem/decisions.json at 100% salience across sessions. | |
| compactAll | No | When true, packs the entire repository structurally (minLines=2, sampled JSON/CSV/SQL, stripped comments) while keeping 100% of elided functions restorable in .vicem/ledger.json. | |
| targetAgent | No | Destination AI coding agent identifier used to format receiver instructions (default: "codex"). | codex |
| budgetTokens | No | Maximum token budget governing how aggressively Tier 3/4 context files are skeletonized (default: 4000, range: 500-128000). |