Directories
¶
| Path | Synopsis |
|---|---|
|
Package acp implements the Agent Communication Protocol — a small HTTP/SSE API that lets other agents (claude code, opencode, custom agents) send messages to a running overkill and receive streaming replies.
|
Package acp implements the Agent Communication Protocol — a small HTTP/SSE API that lets other agents (claude code, opencode, custom agents) send messages to a running overkill and receive streaming replies. |
|
Package agent — Caveman Mode + prompt compression (master plan §4.4).
|
Package agent — Caveman Mode + prompt compression (master plan §4.4). |
|
Package atomicfile provides crash-safe file writes via the temp-then-rename pattern.
|
Package atomicfile provides crash-safe file writes via the temp-then-rename pattern. |
|
Package audit — completion auditor that verifies agent output.
|
Package audit — completion auditor that verifies agent output. |
|
Package auth implements OAuth device-code flows for providers that don't use static API keys (Anthropic Claude.ai, GitHub Copilot, etc.).
|
Package auth implements OAuth device-code flows for providers that don't use static API keys (Anthropic Claude.ai, GitHub Copilot, etc.). |
|
Package automation — alarm persistence backed by PostgreSQL.
|
Package automation — alarm persistence backed by PostgreSQL. |
|
Package automemory extracts explicitly opted-in, bounded durable facts.
|
Package automemory extracts explicitly opted-in, bounded durable facts. |
|
Package browser provides an agent-driven headless Chrome wrapper built on chromedp.
|
Package browser provides an agent-driven headless Chrome wrapper built on chromedp. |
|
devbrowser
Package devbrowser provides a narrow structured Chrome interface.
|
Package devbrowser provides a narrow structured Chrome interface. |
|
Package checkpoint — filesystem checkpoints (master plan §4.8).
|
Package checkpoint — filesystem checkpoints (master plan §4.8). |
|
Package childruntime builds isolated children using the application's agent loop.
|
Package childruntime builds isolated children using the application's agent loop. |
|
Package compaction — LCM-inspired dual-state context management.
|
Package compaction — LCM-inspired dual-state context management. |
|
seahorse
Package seahorse implements hierarchical DAG summarization — a more sophisticated alternative to flat LCM compaction.
|
Package seahorse implements hierarchical DAG summarization — a more sophisticated alternative to flat LCM compaction. |
|
Package config — the Configurable interface.
|
Package config — the Configurable interface. |
|
Package coordination provides durable, project-scoped correspondence between agents.
|
Package coordination provides durable, project-scoped correspondence between agents. |
|
Package credentials stores application credentials in the operating system's credential vault.
|
Package credentials stores application credentials in the operating system's credential vault. |
|
Package credit — retrospective credit assignment (§8.6 Wave 4, approximation of Zhang 2026).
|
Package credit — retrospective credit assignment (§8.6 Wave 4, approximation of Zhang 2026). |
|
Package cron — activity tracking for gateway-aware cron fire dispatch.
|
Package cron — activity tracking for gateway-aware cron fire dispatch. |
|
Package daemon implements the job queue for overkill's daemon mode (§8.7.3).
|
Package daemon implements the job queue for overkill's daemon mode (§8.7.3). |
|
Package db provides shared PostgreSQL connections and central bootstrap migrations.
|
Package db provides shared PostgreSQL connections and central bootstrap migrations. |
|
Package dbschema owns SQL shared by application bootstrap and store startup.
|
Package dbschema owns SQL shared by application bootstrap and store startup. |
|
orphan: agent self-debugging (master plan §5.7); to be invoked from error-recovery flow once a result-channel is plumbed
|
orphan: agent self-debugging (master plan §5.7); to be invoked from error-recovery flow once a result-channel is plumbed |
|
orphan: 'overkill doctor' command runs subset; remaining checks here pending integration into cmd/overkill/doctor.go
|
orphan: 'overkill doctor' command runs subset; remaining checks here pending integration into cmd/overkill/doctor.go |
|
checks
Package checks bundles the individual subsystem checks that the Runner composes for `overkill doctor`.
|
Package checks bundles the individual subsystem checks that the Runner composes for `overkill doctor`. |
|
health
Package health provides the HealthCheck registry — the single best pattern stolen from OpenClaw's src/flows/.
|
Package health provides the HealthCheck registry — the single best pattern stolen from OpenClaw's src/flows/. |
|
Package drift — behavioral drift detection (§8.3 Wave 4).
|
Package drift — behavioral drift detection (§8.3 Wave 4). |
|
Package events provides the completion-event pipeline (§8.7.2).
|
Package events provides the completion-event pipeline (§8.7.2). |
|
sinks
Package sinks provides built-in Sink implementations for CompletionEvents.
|
Package sinks provides built-in Sink implementations for CompletionEvents. |
|
Package extensions is a thin, read-mostly unification layer over the four existing extension surfaces in Overkill: skills, plugins, hooks, and MCP servers (Phase 1.5 #5).
|
Package extensions is a thin, read-mostly unification layer over the four existing extension surfaces in Overkill: skills, plugins, hooks, and MCP servers (Phase 1.5 #5). |
|
Package features is a small runtime feature-flag layer for Overkill (Phase 1.5 #4).
|
Package features is a small runtime feature-flag layer for Overkill (Phase 1.5 #4). |
|
Package flows provides the unified flow type system stolen from OpenClaw's src/flows/.
|
Package flows provides the unified flow type system stolen from OpenClaw's src/flows/. |
|
Package gateway — simple PostgreSQL-backed bookmark store for session bookmarks.
|
Package gateway — simple PostgreSQL-backed bookmark store for session bookmarks. |
|
bridge
Package bridge is a one-size HTTP gateway any sidecar (Baileys for WhatsApp, discord.js, an SMS relay) can plug into.
|
Package bridge is a one-size HTTP gateway any sidecar (Baileys for WhatsApp, discord.js, an SMS relay) can plug into. |
|
discord
Package discord — Discord gateway via discordgo (Batch H).
|
Package discord — Discord gateway via discordgo (Batch H). |
|
matrix
Package matrix implements a Matrix messaging gateway via raw HTTP against the Matrix Client-Server API (no heavy SDK).
|
Package matrix implements a Matrix messaging gateway via raw HTTP against the Matrix Client-Server API (no heavy SDK). |
|
mattermost
Package mattermost implements a Mattermost messaging gateway via the Mattermost WebSocket API (wss://server/api/v4/websocket) for real-time events and the REST API for posting messages.
|
Package mattermost implements a Mattermost messaging gateway via the Mattermost WebSocket API (wss://server/api/v4/websocket) for real-time events and the REST API for posting messages. |
|
signal
Package signal implements a Signal messaging gateway via signal-cli's REST API mode.
|
Package signal implements a Signal messaging gateway via signal-cli's REST API mode. |
|
slack
Package slack — Slack gateway via Socket Mode.
|
Package slack — Slack gateway via Socket Mode. |
|
telegram
Package telegram is a minimal Bot API client used by the Telegram gateway.
|
Package telegram is a minimal Bot API client used by the Telegram gateway. |
|
whatsapp/cloud
Package cloud — WhatsApp Business Cloud API gateway (Batch L, official-path backend).
|
Package cloud — WhatsApp Business Cloud API gateway (Batch L, official-path backend). |
|
whatsapp/whatsmeow
Package whatsmeow — WhatsApp gateway via go.mau.fi/whatsmeow (Batch L, unofficial-path backend).
|
Package whatsmeow — WhatsApp gateway via go.mau.fi/whatsmeow (Batch L, unofficial-path backend). |
|
Package halluscan — conservative hallucination detector (Batch G3).
|
Package halluscan — conservative hallucination detector (Batch G3). |
|
Package hooks — user-defined hooks loaded from disk (master plan §6.3).
|
Package hooks — user-defined hooks loaded from disk (master plan §6.3). |
|
Package hotreload wires live config notifications to an agent.
|
Package hotreload wires live config notifications to an agent. |
|
Package input classifies user-typed text into intent categories so the TUI can route or hint accordingly.
|
Package input classifies user-typed text into intent categories so the TUI can route or hint accordingly. |
|
Package instructions loads explicitly authorized workspace guidance.
|
Package instructions loads explicitly authorized workspace guidance. |
|
orphan: on-demand CODEBASE.md generator (master plan §5.8); needs /introspect slash command
|
orphan: on-demand CODEBASE.md generator (master plan §5.8); needs /introspect slash command |
|
Package journal — CLAIM-CONFIRM async compression queue (§4.19, inspired by claude-mem).
|
Package journal — CLAIM-CONFIRM async compression queue (§4.19, inspired by claude-mem). |
|
Package lats — multi-branch task exploration (§8.5 Wave 4, inspired by Zhou 2024 LATS: Language Agent Tree Search).
|
Package lats — multi-branch task exploration (§8.5 Wave 4, inspired by Zhou 2024 LATS: Language Agent Tree Search). |
|
Package learning implements a lightweight learning-from-corrections system.
|
Package learning implements a lightweight learning-from-corrections system. |
|
Package localdb owns a private, bundled PostgreSQL cluster for one application session.
|
Package localdb owns a private, bundled PostgreSQL cluster for one application session. |
|
Package lsp implements a minimal Language Server Protocol client over stdio.
|
Package lsp implements a minimal Language Server Protocol client over stdio. |
|
Package mcp implements a Go client for the Model Context Protocol.
|
Package mcp implements a Go client for the Model Context Protocol. |
|
testfixture
Package testfixture supplies a controlled local MCP subprocess for acceptance tests.
|
Package testfixture supplies a controlled local MCP subprocess for acceptance tests. |
|
Package memory — semantic + episodic memory orchestration (Go side).
|
Package memory — semantic + episodic memory orchestration (Go side). |
|
Package models is the TOML-as-data model catalog (master plan §4.2).
|
Package models is the TOML-as-data model catalog (master plan §4.2). |
|
Package modelusage propagates actual model-call accounting across optional middleware without depending on the agent or changing provider contracts.
|
Package modelusage propagates actual model-call accounting across optional middleware without depending on the agent or changing provider contracts. |
|
Package multimodal — audio transcription via whisper.cpp.
|
Package multimodal — audio transcription via whisper.cpp. |
|
Package personality — blind-spot tracking: patterns the agent overestimates its ability on, used for self-awareness nudges before executing risky operations.
|
Package personality — blind-spot tracking: patterns the agent overestimates its ability on, used for self-awareness nudges before executing risky operations. |
|
orphan: vertical slicer (master plan §5.4); needs /slice slash command
|
orphan: vertical slicer (master plan §5.4); needs /slice slash command |
|
Package plan — current-task plan + todo store.
|
Package plan — current-task plan + todo store. |
|
Package playbooks — ACE-style evolving playbooks (§8.2 Phase 5 #6, inspired by Zhang 2025 Agentic Context Engineering).
|
Package playbooks — ACE-style evolving playbooks (§8.2 Phase 5 #6, inspired by Zhang 2025 Agentic Context Engineering). |
|
Package plugin implements a subprocess-based plugin runtime for Overkill.
|
Package plugin implements a subprocess-based plugin runtime for Overkill. |
|
Package processrunner executes bounded subprocess trees on Unix and Windows.
|
Package processrunner executes bounded subprocess trees on Unix and Windows. |
|
Package prompt provides a modular context chip system for injecting dynamic context into the AI agent's prompt.
|
Package prompt provides a modular context chip system for injecting dynamic context into the AI agent's prompt. |
|
chips
Package chips provides built-in context chips for the Overkill agent.
|
Package chips provides built-in context chips for the Overkill agent. |
|
Package providers — canonical provider default URLs, env vars, and base configuration.
|
Package providers — canonical provider default URLs, env vars, and base configuration. |
|
Package pty wraps github.com/creack/pty to provide a simple Session type for running interactive commands inside a pseudo-terminal.
|
Package pty wraps github.com/creack/pty to provide a simple Session type for running interactive commands inside a pseudo-terminal. |
|
Package reflect — Reflexion-class self-correction (paper #51 AlphaGRPO / Shinn 2023 Reflexion).
|
Package reflect — Reflexion-class self-correction (paper #51 AlphaGRPO / Shinn 2023 Reflexion). |
|
Package rewriter provides LLM prompt rewriter middleware (master plan §6.x).
|
Package rewriter provides LLM prompt rewriter middleware (master plan §6.x). |
|
Package routing — adapter that lets a SmartRouter satisfy the agent.ModelRouter contract without the agent package importing routing.
|
Package routing — adapter that lets a SmartRouter satisfy the agent.ModelRouter contract without the agent package importing routing. |
|
Package runtimedb resolves explicit database configuration and owns the pool and, only when requested, a private local PostgreSQL process.
|
Package runtimedb resolves explicit database configuration and owns the pool and, only when requested, a private local PostgreSQL process. |
|
Package security — encoding-aware scan layer.
|
Package security — encoding-aware scan layer. |
|
Package session — prompt stash storage.
|
Package session — prompt stash storage. |
|
Package settings provides a declarative, reflection-based settings system for Overkill, inspired by Warp's define_settings_group! macro.
|
Package settings provides a declarative, reflection-based settings system for Overkill, inspired by Warp's define_settings_group! macro. |
|
Package shadows — hidden easter eggs and secret commands.
|
Package shadows — hidden easter eggs and secret commands. |
|
Package share renders a session as a self-contained HTML page and uploads it to a paste service for easy URL-based sharing.
|
Package share renders a session as a self-contained HTML page and uploads it to a paste service for easy URL-based sharing. |
|
Package skills — context-aware activation conditions (Phase 1.5 #7).
|
Package skills — context-aware activation conditions (Phase 1.5 #7). |
|
registry
Package registry — ClawHub-compatible HTTP client for skill discovery + install (§6.4).
|
Package registry — ClawHub-compatible HTTP client for skill discovery + install (§6.4). |
|
safety
Package safety — antivirus scanning for skill files (§6.4).
|
Package safety — antivirus scanning for skill files (§6.4). |
|
Deprecated: This package is the pre-gateway Slack bot implementation.
|
Deprecated: This package is the pre-gateway Slack bot implementation. |
|
Package speculation provides idle-time predictive execution.
|
Package speculation provides idle-time predictive execution. |
|
Package speculative — read cache + prefetcher for §8.5 Phase 5 speculative tool execution.
|
Package speculative — read cache + prefetcher for §8.5 Phase 5 speculative tool execution. |
|
Package subagent — autonomous-execution loop.
|
Package subagent — autonomous-execution loop. |
|
Package sync ships local Overkill sessions to a remote backend so the user can switch machines and resume.
|
Package sync ships local Overkill sessions to a remote backend so the user can switch machines and resume. |
|
Package tags stores user-applied annotations on file paths.
|
Package tags stores user-applied annotations on file paths. |
|
Package tasks — cross-session task graph (§8.3 Phase 5 #2).
|
Package tasks — cross-session task graph (§8.3 Phase 5 #2). |
|
Package term — OSC 10/11 background-color probe (master plan §5.1).
|
Package term — OSC 10/11 background-color probe (master plan §5.1). |
|
Package testpg provides isolated PostgreSQL schemas for integration tests.
|
Package testpg provides isolated PostgreSQL schemas for integration tests. |
|
Package testsocket creates private, short-lived paths for Unix socket tests.
|
Package testsocket creates private, short-lived paths for Unix socket tests. |
|
Package tools — alarm_set / alarm_list / alarm_cancel tools exposed to the agent.
|
Package tools — alarm_set / alarm_list / alarm_cancel tools exposed to the agent. |
|
bash
Package bash provides security classification for shell commands.
|
Package bash provides security classification for shell commands. |
|
imagegen
Package imagegen provides text-to-image generation tools for Overkill.
|
Package imagegen provides text-to-image generation tools for Overkill. |
|
messaging
Package messaging provides cross-platform messaging tools for Overkill.
|
Package messaging provides cross-platform messaging tools for Overkill. |
|
tts
Package tts provides text-to-speech tools for Overkill.
|
Package tts provides text-to-speech tools for Overkill. |
|
Package verify — default registry wiring + tool-input path extraction.
|
Package verify — default registry wiring + tool-input path extraction. |
|
Package vision turns image bytes into prose a text-only main agent can reason over (master plan §7.4).
|
Package vision turns image bytes into prose a text-only main agent can reason over (master plan §7.4). |
|
Package walls — OVERKILL_ARCH.md + CONTEXT.md generation (master plan §6.5 Wall 2).
|
Package walls — OVERKILL_ARCH.md + CONTEXT.md generation (master plan §6.5 Wall 2). |
|
impossibleprobe
Package impossibleprobe — ImpossibleBench-style cheating detection (§8.4 Zhong 2025).
|
Package impossibleprobe — ImpossibleBench-style cheating detection (§8.4 Zhong 2025). |
|
mcpshield
Package mcpshield — MCP tool-call policy layer (§8.4 MCPSHIELD, Acharya 2026).
|
Package mcpshield — MCP tool-call policy layer (§8.4 MCPSHIELD, Acharya 2026). |
|
monitor
Package monitor — heuristic detectors (Wall 4, paper #48).
|
Package monitor — heuristic detectors (Wall 4, paper #48). |
|
promptinject
Package promptinject — prompt-injection scanner (§8.4 Owner-Harm threat model, Zhang 2026).
|
Package promptinject — prompt-injection scanner (§8.4 Owner-Harm threat model, Zhang 2026). |
|
truthsource
Package truthsource — "user is source of truth" behavioral wall (§8.7.6).
|
Package truthsource — "user is source of truth" behavioral wall (§8.7.6). |
|
Package web serves the Overkill browser UI: an embedded SPA over HTTP plus a WebSocket event channel for live agent streams.
|
Package web serves the Overkill browser UI: an embedded SPA over HTTP plus a WebSocket event channel for live agent streams. |
|
Package worktree manages isolated task checkouts without discarding user work.
|
Package worktree manages isolated task checkouts without discarding user work. |
Click to show internal directories.
Click to hide internal directories.