Architecture
Silk Code separates the developer-owned coding environment from replaceable cloud or local AI models.
Major layers
| Layer | Responsibility |
|---|---|
| Interfaces | Terminal REPL, one-shot CLI, and local multi-session web GUI. |
| Agent harness | Repository context, tool orchestration, permissions, checkpoints, compaction, and verification. |
| Provider layer | Cloud APIs, OpenAI-compatible endpoints, Ollama, and local-model discovery. |
| Tools | Filesystem editing, tests, git, GitHub, MCP, sandbox execution, and benchmarks. |
| Persistence | Resumable sessions, project memory, rules, and provenance metadata. |
Design principles
- The coding environment belongs to the developer.
- The AI model is replaceable.
- Tool actions remain permission-gated and auditable.
- Verification is part of the agent loop.
Detailed specification
See the project’s Software Requirements Specification for the authoritative design.