Directories
¶
| Path | Synopsis |
|---|---|
|
Package acp implements an Agent Client Protocol (ACP) server for hawk, exposing the agent over newline-delimited JSON-RPC 2.0 on stdio so editors (e.g.
|
Package acp implements an Agent Client Protocol (ACP) server for hawk, exposing the agent over newline-delimited JSON-RPC 2.0 on stdio so editors (e.g. |
|
Package autoinit performs a one-time, automatic codebase-analysis pass the first time hawk runs in a project that has no context files (AGENTS.md / HAWK.md / CLAUDE.md).
|
Package autoinit performs a one-time, automatic codebase-analysis pass the first time hawk runs in a project that has no context files (AGENTS.md / HAWK.md / CLAUDE.md). |
|
bridge
|
|
|
sessioncapture
Package sessioncapture provides terminal context capture with delta-based tracking.
|
Package sessioncapture provides terminal context capture with delta-based tracking. |
|
trace
Package tracebridge provides a Go library bridge that wraps trace's functionality for use by hawk, replacing the subprocess-based approach.
|
Package tracebridge provides a Go library bridge that wraps trace's functionality for use by hawk, replacing the subprocess-based approach. |
|
Package cmdhistory implements a structured command history store using SQLite.
|
Package cmdhistory implements a structured command history store using SQLite. |
|
Package validator provides config validation utilities.
|
Package validator provides config validation utilities. |
|
Package container provides Docker container lifecycle management for hawk's sandboxed execution environments.
|
Package container provides Docker container lifecycle management for hawk's sandboxed execution environments. |
|
Package context provides hierarchical context discovery for hawk.
|
Package context provides hierarchical context discovery for hawk. |
|
repomap
Package repomap is the prompt-injection shim that produces a token-budgeted repository overview for hawk's context layer.
|
Package repomap is the prompt-injection shim that produces a token-budgeted repository overview for hawk's context layer. |
|
Package daemon provides a Telegram gateway for hawk.
|
Package daemon provides a Telegram gateway for hawk. |
|
Package deps documents the dependency injection pattern used across hawk.
|
Package deps documents the dependency injection pattern used across hawk. |
|
This file re-exports symbols from the agent sub-package so that existing callers of engine.SubAgentMode, engine.NewSubAgentBudget, etc.
|
This file re-exports symbols from the agent sub-package so that existing callers of engine.SubAgentMode, engine.NewSubAgentBudget, etc. |
|
agent
Package agent is the namespace for sub-agent orchestration types.
|
Package agent is the namespace for sub-agent orchestration types. |
|
code
Package code provides code-aware features: context extraction, lenses, actions, and explainer.
|
Package code provides code-aware features: context extraction, lenses, actions, and explainer. |
|
compact
Package compact provides compaction strategies, types, and helpers for context-window management.
|
Package compact provides compaction strategies, types, and helpers for context-window management. |
|
control
Package control provides engine control-flow safety types — loop detection, stall detection, and backtracking.
|
Package control provides engine control-flow safety types — loop detection, stall detection, and backtracking. |
|
cost
Package cost provides cost tracking, optimisation, and display for the hawk engine.
|
Package cost provides cost tracking, optimisation, and display for the hawk engine. |
|
ctxmgr
Package ctxmgr is the namespace for context budget, decay, packing, providers, visualisation, and read-only context.
|
Package ctxmgr is the namespace for context budget, decay, packing, providers, visualisation, and read-only context. |
|
diff
Package diff is the Stage-1 namespace for diff sandbox, staging, preview, summariser, test selector, and 3-way merge.
|
Package diff is the Stage-1 namespace for diff sandbox, staging, preview, summariser, test selector, and 3-way merge. |
|
docs
Package docs provides documentation generation, external docs fetching, and doc updating types.
|
Package docs provides documentation generation, external docs fetching, and doc updating types. |
|
errs
Package errs provides error context enrichment, grouping, learning, patterns, and recovery for the hawk engine.
|
Package errs provides error context enrichment, grouping, learning, patterns, and recovery for the hawk engine. |
|
git
Package git provides git-context enrichment and remote-forge integration.
|
Package git provides git-context enrichment and remote-forge integration. |
|
intelligence
Package intelligence is the Stage-1 namespace for intent classification, capabilities, language support, tool selection.
|
Package intelligence is the Stage-1 namespace for intent classification, capabilities, language support, tool selection. |
|
io
Package io provides clipboard, AI watcher, file watcher, and cron scheduler types.
|
Package io provides clipboard, AI watcher, file watcher, and cron scheduler types. |
|
lifecycle
Package lifecycle is the Stage-1 namespace for session lifecycle, limits, timeouts, and sleep-time operations.
|
Package lifecycle is the Stage-1 namespace for session lifecycle, limits, timeouts, and sleep-time operations. |
|
memory
Package memory provides knowledge, experience, and memory consolidation types.
|
Package memory provides knowledge, experience, and memory consolidation types. |
|
observability
Package observability is the Stage-1 namespace for profiling, debug recording, structured logging, feedback.
|
Package observability is the Stage-1 namespace for profiling, debug recording, structured logging, feedback. |
|
planning
Package planning is the Stage-1 namespace for task planning, decomposition, goals, and suggested tasks.
|
Package planning is the Stage-1 namespace for task planning, decomposition, goals, and suggested tasks. |
|
project
Package project is the Stage-1 namespace for project analysis, snapshots, impact analysis, dep updates, migrations, releases.
|
Package project is the Stage-1 namespace for project analysis, snapshots, impact analysis, dep updates, migrations, releases. |
|
prompt
Package prompt provides prompt-construction and prompt-optimisation types.
|
Package prompt provides prompt-construction and prompt-optimisation types. |
|
retry
Package retry provides retry-queue and smart-retry types for the engine package.
|
Package retry provides retry-queue and smart-retry types for the engine package. |
|
review
Package review is the Stage-1 namespace for self-review / critique / quality scoring types in package engine.
|
Package review is the Stage-1 namespace for self-review / critique / quality scoring types in package engine. |
|
scaffold
Package scaffold is the Stage-1 namespace for scaffolding, recipes, patterns, skills, and few-shot types.
|
Package scaffold is the Stage-1 namespace for scaffolding, recipes, patterns, skills, and few-shot types. |
|
search
Package search provides URL scraping, issue search, and research agent types.
|
Package search provides URL scraping, issue search, and research agent types. |
|
session
Package session is the Stage-1 namespace for session-lifecycle types in package engine.
|
Package session is the Stage-1 namespace for session-lifecycle types in package engine. |
|
streaming
Package streaming is the Stage-1 namespace for response caching, formatting, stream optimisation, thinking protocol, and steering.
|
Package streaming is the Stage-1 namespace for response caching, formatting, stream optimisation, thinking protocol, and steering. |
|
token
Package token is the Stage-1 namespace for token-related types and functions in package engine.
|
Package token is the Stage-1 namespace for token-related types and functions in package engine. |
|
validation
Package validation is the Stage-1 namespace for generated-code validation, schema validation, test loops, and lint loops.
|
Package validation is the Stage-1 namespace for generated-code validation, schema validation, test loops, and lint loops. |
|
workflow
Package workflow is the Stage-1 namespace for workflow + workspace + trajectory types in package engine.
|
Package workflow is the Stage-1 namespace for workflow + workspace + trajectory types in package engine. |
|
feature
|
|
|
ide
Package ide provides IDE integration hints and metadata.
|
Package ide provides IDE integration hints and metadata. |
|
shellmode
Package shellmode implements the ! prefix for direct shell command execution in the REPL input, bypassing the LLM entirely.
|
Package shellmode implements the ! prefix for direct shell command execution in the REPL input, bypassing the LLM entirely. |
|
taste
Package taste implements a learning system that observes user coding preferences and builds a style profile over time to improve agent output alignment.
|
Package taste implements a learning system that observes user coding preferences and builds a style profile over time to improve agent output alignment. |
|
audit
Package audit provides waste-detection detectors for agent transcripts.
|
Package audit provides waste-detection detectors for agent transcripts. |
|
intelligence
|
|
|
planner
Package planner implements structured planning that generates artifacts before coding begins.
|
Package planner implements structured planning that generates artifacts before coding begins. |
|
repomap
api_scanner.go discovers HTTP endpoints in a project by detecting the framework (Chi, net/http, Gin, Echo, Gorilla mux, or Fiber) and extracting route declarations into an APIMap.
|
api_scanner.go discovers HTTP endpoints in a project by detecting the framework (Chi, net/http, Gin, Echo, Gorilla mux, or Fiber) and extracting route declarations into an APIMap. |
|
Package jsonc is a minimal JSON-with-Comments (JSONC) parser.
|
Package jsonc is a minimal JSON-with-Comments (JSONC) parser. |
|
Package lint provides a per-language linter/auto-fix cycle that can be invoked after hawk writes or edits a file.
|
Package lint provides a per-language linter/auto-fix cycle that can be invoked after hawk writes or edits a file. |
|
Package localize implements hierarchical fault localization inspired by OpenAutoCoder/Agentless.
|
Package localize implements hierarchical fault localization inspired by OpenAutoCoder/Agentless. |
|
Package lsp provides a Language Server Protocol client for hawk.
|
Package lsp provides a Language Server Protocol client for hawk. |
|
Package mention implements @-prefixed file mentions in prompt input, enabling users to reference project files that get auto-included as context.
|
Package mention implements @-prefixed file mentions in prompt input, enabling users to reference project files that get auto-included as context. |
|
Package mission provides multi-feature parallel execution for hawk.
|
Package mission provides multi-feature parallel execution for hawk. |
|
logger
Package logger provides structured logging with levels.
|
Package logger provides structured logging with levels. |
|
metrics
Package metrics provides basic metrics collection (counters, timers, gauges).
|
Package metrics provides basic metrics collection (counters, timers, gauges). |
|
oteltrace
Package trace provides Langfuse tracing integration for LLM observability.
|
Package trace provides Langfuse tracing integration for LLM observability. |
|
verdict.go: a unified PermissionVerdict type that consolidates the outcome shape across all permission subsystems (guardian, rules DSL, boundary checker, tool dispatcher, hooks, etc.).
|
verdict.go: a unified PermissionVerdict type that consolidates the outcome shape across all permission subsystems (guardian, rules DSL, boundary checker, tool dispatcher, hooks, etc.). |
|
Package profile provides runtime profiling helpers.
|
Package profile provides runtime profiling helpers. |
|
Package prompt provides the system prompt for hawk.
|
Package prompt provides the system prompt for hawk. |
|
Package prompts manages workspace context for hawk sessions.
|
Package prompts manages workspace context for hawk sessions. |
|
provider
|
|
|
routing
Package routing provides model routing and health checking.
|
Package routing provides model routing and health checking. |
|
Package providers catalogs the AI coding agents that hawk can be invoked from.
|
Package providers catalogs the AI coding agents that hawk can be invoked from. |
|
Package recipe also provides declarative provider configuration.
|
Package recipe also provides declarative provider configuration. |
|
Package circuit provides a circuit breaker pattern for resilience.
|
Package circuit provides a circuit breaker pattern for resilience. |
|
health
Package health provides health check and readiness probe support.
|
Package health provides health check and readiness probe support. |
|
ratelimit
Package ratelimit provides token bucket rate limiting.
|
Package ratelimit provides token bucket rate limiting. |
|
retry
Package retry provides configurable retry logic with exponential backoff.
|
Package retry provides configurable retry logic with exponential backoff. |
|
Package rules provides import/export of AI coding rules between different tool formats (hawk, Cursor, Claude Code, Copilot, Gemini).
|
Package rules provides import/export of AI coding rules between different tool formats (hawk, Cursor, Claude Code, Copilot, Gemini). |
|
Package safewrite provides a hardened file-write helper that protects against common symlink and permission attacks.
|
Package safewrite provides a hardened file-write helper that protects against common symlink and permission attacks. |
|
Package sandbox provides sandbox mode for isolated command execution.
|
Package sandbox provides sandbox mode for isolated command execution. |
|
session_gain.go: per-session gain tracking for compression events.
|
session_gain.go: per-session gain tracking for compression events. |
|
shutdown
Package shutdown provides graceful shutdown handling for applications.
|
Package shutdown provides graceful shutdown handling for applications. |
|
staleness
Package staleness detects rules/skills that are no longer actively used or that contradict observed user behavior.
|
Package staleness detects rules/skills that are no longer actively used or that contradict observed user behavior. |
|
Package testaudit provides meta-audit tests that enforce architectural invariants across the hawk codebase using go/ast analysis.
|
Package testaudit provides meta-audit tests that enforce architectural invariants across the hawk codebase using go/ast analysis. |
|
Package tool provides built-in tools for the hawk coding agent.
|
Package tool provides built-in tools for the hawk coding agent. |
|
Package types provides Hawk-owned runtime types and shared compatibility aliases.
|
Package types provides Hawk-owned runtime types and shared compatibility aliases. |
|
ui
|
|
|
icons
Package icons is hawk's centralized icon registry.
|
Package icons is hawk's centralized icon registry. |
Click to show internal directories.
Click to hide internal directories.