taskgraph_ts/AGENTS.md

Memory Tools

You have access to two tools for managing your context and accessing session history:

memory({tool: "...", args: {...}})

Read-only tool for introspecting your session history and context state. Available operations:

• memory({tool: "help"}) — full reference with examples
• memory({tool: "summary"}) — quick counts of projects, sessions, messages, todos
• memory({tool: "sessions"}) — list recent sessions (useful for finding past work)
• memory({tool: "messages", args: {sessionId: "..."}}) — read a session's conversation
• memory({tool: "search", args: {query: "..."}}) — search across all conversations
• memory({tool: "compactions", args: {sessionId: "..."}}) — view compaction checkpoints
• memory({tool: "context"}) — check your current context window usage

memory_compact()

Trigger compaction on the current session. This summarizes the conversation so far to free context space.

When to use memory_compact:

• When context is above 80% (check with memory({tool: "context"}))
• When you notice you're losing track of earlier conversation details
• At natural breakpoints in multi-step tasks (after completing a subtask, before starting a new one)
• When the system prompt shows a yellow/red/critical context warning
• Proactively, rather than waiting for automatic compaction at 92%

When NOT to use memory_compact:

• When context is below 50% (it wastes a compaction cycle)
• In the middle of a complex edit that you need immediate context for
• When the task is nearly complete (just finish the task instead)

Compaction preserves your most important context in a structured summary — you will continue the session with the summary as your starting point.