How whyiyhw/seek works
seek is a local coding-agent platform. A user starts it through the CLI or an editor/browser/headless surface; the agent runs model-backed tool turns, with planning, goals, and sub-agents supporting larger tasks. Sessions, memory, skills, checkpoints, and scheduled routines preserve or extend work. The README documents several capabilities whose detailed implementations were not sampled; those branches are shown at subsystem-directory granularity. Edges use the README or SOURCE INDEX where available, so some internal wiring is intentionally omitted.
Main entry points: agent.go Agent loop · main.go CLI entry · tui Terminal UI · controlplane Browser control
Components 24
Entry surfaces
- CLI entry
cmd/seek/main.go - Terminal UI
internal/tui - Browser control
internal/controlplane - ACP editor
internal/acp - JSON-RPC
internal/rpc
Agent runtime
- Agent loop
pkg/agent/agent.go - Agent tools
internal/tools - System prompt
internal/sysprompt/sysprompt.go
Work orchestration
- Plan workflow
internal/tools/plan - Goal loop
internal/goal - Autopilot fleet
internal/autopilot - Sub-agents
internal/subagent/manager.go - Git worktrees
internal/worktree/worktree.go - Scheduled runs
internal/routines
Knowledge and state
- Session history
internal/session/session.go - Three-tier memory
internal/memory - Skills lifecycle
internal/skillmgr/skillmgr.go - Skill distillation
internal/skilldistill/skilldistill.go - Checkpoints
internal/checkpoint/file.go
Providers and integrations
- LLM providers
pkg/llm - DeepSeek API
pkg/deepseek/client.go - MCP servers
pkg/mcp/client.go
Other components
- User or host
- Model APIs
Connections 28
- User or host → CLI entry: starts
README.md - CLI entry → Terminal UI: opens
README.md - CLI entry → Browser control: serves
README.md - CLI entry → ACP editor: starts
README.md - CLI entry → JSON-RPC: starts
README.md - Terminal UI → Agent loop: prompts
README.md - Browser control → Agent loop: drives
README.md - ACP editor → Agent loop: drives
README.md - JSON-RPC → Agent loop: prompts
internal/rpc/server.go - Agent loop → Agent tools: invokes
pkg/agent/agent.go - Agent loop → LLM providers: streams via
pkg/agent/agent.go - Agent loop → DeepSeek API: uses
pkg/agent/agent.go - Agent loop → System prompt: uses
pkg/agent/agent.go - Agent tools → MCP servers: bridges
- User or host → Plan workflow: approves
README.md - Plan workflow → Agent loop: gates work
README.md - CLI entry → Goal loop: runs
README.md - Goal loop → Agent loop: runs turns
internal/goal/agentworker.go - CLI entry → Autopilot fleet: runs
README.md - Autopilot fleet → Sub-agents: dispatches
README.md - Sub-agents → Git worktrees: isolates in
README.md - CLI entry → Scheduled runs: schedules
README.md - Agent loop → Session history: persists
- Agent loop → Three-tier memory: uses
- Agent loop → Skills lifecycle: loads
- Session history → Skill distillation: distills into
README.md - Terminal UI → Checkpoints: undoes via
internal/tui/commands.go - LLM providers → Model APIs: calls