How ameertechy/jcode works
jcode is a Rust coding-agent harness designed for interactive and multi-session work. The main workflow is a user interacting through the terminal UI, which communicates with the server; the server creates and manages sessions, and an agent runs turns using registered tools and a model provider. Supporting branches include swarm coordination, ambient tasks, configuration and authentication, and session persistence. Relationships are limited to those visible in the README or SOURCE INDEX references; some runtime wiring and provider integrations were not sampled.
Main entry points: server.rs Harness server · client_session.rs Client sessions · agent.rs Agent turns · catalog_routes.rs Model providers
Components 15
User interfaces
- Terminal UI
crates/jcode-tui/src/tui/app.rs - Desktop UI
crates/jcode-desktop2/src/main.rs
Agent runtime
- Agent turns
crates/jcode-app-core/src/agent.rs - Tool registry
crates/jcode-app-core/src/tool/mod.rs - Ambient tasks
crates/jcode-app-core/src/tool/ambient.rs
Sessions and coordination
- Harness server
crates/jcode-app-core/src/server.rs - Client sessions
crates/jcode-app-core/src/server/client_session.rs - Client state
crates/jcode-app-core/src/server/client_state.rs - Swarm coordination
crates/jcode-app-core/src/server/swarm.rs
Providers and platform
- Model providers
crates/jcode-base/src/provider/catalog_routes.rs - Authentication
crates/jcode-base/src/auth/mod.rs - Configuration
crates/jcode-base/src/config.rs - Persistent storage
crates/jcode-base/src/storage.rs
Other components
- User
- Model service
Connections 16
- User → Terminal UI: interacts with
- User → Desktop UI: interacts with
- Terminal UI → Harness server: communicates with
- Desktop UI → Harness server: connects through harness API
crates/jcode-desktop2/src/main.rs - Harness server → Client sessions: manages
crates/jcode-app-core/src/server.rs - Client sessions → Agent turns: uses
crates/jcode-app-core/src/server/client_session.rs - Client sessions → Client state: uses
crates/jcode-app-core/src/server/client_session.rs - Harness server → Agent turns: creates turns
crates/jcode-app-core/src/server.rs - Agent turns → Tool registry: dispatches tools
crates/jcode-app-core/src/agent.rs - Tool registry → Ambient tasks: registers tool
crates/jcode-app-core/src/tool/mod.rs - Harness server → Swarm coordination: coordinates
crates/jcode-app-core/src/server.rs - Harness server → Model providers: selects routes
- Model providers → Model service: requests completions
- Model providers → Authentication: checks credentials
crates/jcode-base/src/provider/catalog_routes.rs - Agent turns → Configuration: reads settings
- Client sessions → Persistent storage: persists session data