How akhtarshadab/deepseek-harness works
DeepSeek Harness is a plugin-oriented agent harness with a local Web UI and CLI entry point. Its main user workflow is composing a prompt, managing a session, and observing the agent conversation; session and workspace APIs provide the control layer between client features and runtime behavior. The repository also exposes SDK and ACP interfaces, attachments, session search/export, and an experimental inspector. Several runtime areas are represented only by the tree or documentation, so the graph shows those capabilities without asserting undocumented call chains.
Main entry points: manager.ts Session manager · agent.ts Agent control · server.ts SDK JSON-RPC · main.ts Web app
Components 21
Entry points
- CLI
apps/cli/src/bin.ts - Web app
apps/web/src/main.ts - Web bundle
packages/bundle/web-app/src/startup.ts
Client experience
- Conversation UI
packages/client/ui-conversation/src/client/skeleton/InputBar.tsx - Chat transcript
packages/client/ui-chat/src/client/chat/ChatView.tsx - Client connection
packages/client/connection/src/client/connection.ts
Session control
- Session manager
packages/api/session-controller/src/client/sessions/manager.ts - Session API
packages/api/session-controller/src/index.ts - Workspace API
packages/api/workspace-controller/src/index.ts - Agent control
packages/api/session-controller/src/agent.ts
Agent interfaces
- Harness runtime
packages/bundle/base/src/index.ts - SDK JSON-RPC
packages/sdk/server/src/server.ts - ACP protocol
packages/acp/acp/src/index.ts
Supporting capabilities
- Attachment handling
packages/attachment/attachment-local/src/index.ts - Session search
packages/session-query/session-query-sqlite/src/query.ts - Log export
packages/session-query/session-log-export/src/client/controller.ts - Inspector host
packages/experimental/inspector/src/host/bridge/controller.ts - Inspector queries
packages/experimental/inspector/src/worker/inspection/query-router.ts - Inspector client
packages/experimental/inspector/src/client/bridge/controller.ts - Linux sandbox
native/landlock-run/packages/entry/src/main.c
Other components
- User
Connections 17
- User → CLI: launches
- User → Web app: uses
- Web app → Web bundle: starts
- User → Conversation UI: composes prompt
- Conversation UI → Client connection: submits via
- Client connection → Session manager: transports requests
- Session manager → Session API: uses session control
- Session manager → Chat transcript: provides session view
- Session API → Agent control: controls agent
- Agent control → Harness runtime: operates in
- SDK JSON-RPC → Agent control: submits followups
- SDK JSON-RPC → Attachment handling: admits images
- ACP protocol → Harness runtime: protocol integration
- User → Session search: searches sessions
- User → Log export: downloads logs
- Inspector host → Inspector queries: dispatches queries
- Inspector client → Inspector host: connects to