How copperpilot/copper-pilot-cli works
CopperPilot is a terminal client for a hosted electronics-design agent. A user launches the CLI, selects a workspace and chat mode, authenticates, and sends a request; the hosted service streams responses and local tool requests, which the client brokers and presents. Local graph checkpoints support thread resumption. The package also exposes the hosted agent through MCP and LangChain adapters. The README documents these capabilities; some implementation details are unsampled, so their links are limited to documented or indexed references.
Main entry points: copper_main.py CLI entry · copper_app.py Chat interface · copper_graph.py Checkpointed runtime · langchain.py LangChain adapter
Components 20
CLI and UI
- CLI entry
src/copper_pilot_cli/copper_main.py - Chat interface
src/copper_pilot_cli/copper_app.py - Chat widgets
src/copper_pilot_cli/copper_widgets.py - Presentation
src/copper_pilot_cli/copper_presentation.py
Agent runtime
- Checkpointed runtime
src/copper_pilot_cli/copper_graph.py - Hosted chat protocol
src/copper_pilot_cli/copper_protocol.py - Tool approval bridge
src/copper_pilot_cli/deepagents_tools.py - Agent features
src/copper_pilot_cli/copper_features.py - Media handling
src/copper_pilot_cli/media_utils.py
Workspace and state
- Workspace discovery
src/copper_pilot_cli/copper_workspace.py - Device authentication
src/copper_pilot_cli/copper_auth.py - User configuration
src/copper_pilot_cli/copper_config.py - Thread persistence
src/copper_pilot_cli/sessions.py
External interfaces
- MCP server
src/copper_pilot_cli/copper_mcp.py - LangChain adapter
src/copper_pilot_cli/langchain.py
Other components
- CLI user
- CopperPilot service
- Workspace tools
- MCP host
- LangChain caller
Connections 27
- CLI user → CLI entry: launches
README.md - CLI entry → Chat interface: starts
src/copper_pilot_cli/copper_main.py - CLI entry → Workspace discovery: selects
src/copper_pilot_cli/copper_main.py - CLI entry → Device authentication: authenticates
src/copper_pilot_cli/copper_main.py - CLI entry → Checkpointed runtime: runs
src/copper_pilot_cli/copper_main.py - CLI entry → Thread persistence: lists threads
src/copper_pilot_cli/copper_main.py - CLI entry → MCP server: starts server
src/copper_pilot_cli/copper_main.py - CLI entry → LangChain adapter: exposes adapter
src/copper_pilot_cli/copper_main.py - Chat interface → Chat widgets: renders
src/copper_pilot_cli/copper_app.py - Chat interface → Checkpointed runtime: runs turns
src/copper_pilot_cli/copper_app.py - Chat interface → Tool approval bridge: requests approval
src/copper_pilot_cli/copper_app.py - Chat interface → Media handling: prepares attachments
src/copper_pilot_cli/copper_app.py - Chat interface → Agent features: loads skills
src/copper_pilot_cli/copper_app.py - Checkpointed runtime → LangChain adapter: invokes
src/copper_pilot_cli/copper_graph.py - Checkpointed runtime → Thread persistence: checkpoints
src/copper_pilot_cli/copper_graph.py - LangChain adapter → Hosted chat protocol: builds requests
src/copper_pilot_cli/langchain.py - LangChain adapter → Tool approval bridge: brokers tools
src/copper_pilot_cli/langchain.py - Hosted chat protocol → CopperPilot service: streams chat
src/copper_pilot_cli/copper_protocol.py - Hosted chat protocol → Workspace tools: dispatches requests
src/copper_pilot_cli/copper_protocol.py - Tool approval bridge → Workspace tools: executes approved actions
README.md - Device authentication → CopperPilot service: logs in
src/copper_pilot_cli/copper_auth.py - Device authentication → User configuration: stores credentials
src/copper_pilot_cli/copper_auth.py - Workspace discovery → User configuration: uses paths
src/copper_pilot_cli/copper_workspace.py - MCP host → MCP server: connects over stdio
README.md - MCP server → Checkpointed runtime: delegates turns
src/copper_pilot_cli/copper_mcp.py - LangChain caller → LangChain adapter: invokes runnable
README.md - Presentation → Chat interface: supports display
src/copper_pilot_cli/copper_app.py