Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.opengoat.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Session Semantics

OpenGoat maintains continuity per agent + session key/id.
  • Default session key is main.
  • --session <key|id> reuses an existing logical thread.
  • --new-session forces a fresh session id.
  • --no-session runs statelessly.

​
Where Sessions Are Stored

  • Transcript/session state: agents/<agent-id>/sessions/
  • Run traces: runs/

​
Core Commands

opengoat session list [--agent <id>] [--active-minutes <n>] [--json]
opengoat session history [--agent <id>] [--session <key|id>] [--limit <n>] [--include-compaction] [--json]
opengoat session reset [--agent <id>] [--session <key|id>]
opengoat session compact [--agent <id>] [--session <key|id>]
opengoat session rename --title <text> [--agent <id>] [--session <key|id>] [--json]
opengoat session remove [--agent <id>] [--session <key|id>] [--json]
Agent defaults for all commands: config.defaultAgent / OPENGOAT_DEFAULT_AGENT / goat.

​
Practical Patterns

​
Continue one workstream

opengoat agent goat --session q2-planning --message "Create release plan"
opengoat agent goat --session q2-planning --message "Now generate milestones"

​
Compact long transcripts

opengoat session compact --agent goat --session q2-planning

​
Reset context while keeping session key

opengoat session reset --agent goat --session q2-planning