# Mythos Router

Mythos Router is a local CLI for verifiable AI-assisted coding. It forces model output and external-agent file actions through Strict Write Discipline: validate, apply, verify actual filesystem state, roll back failed writes, and write local receipts.

## Main paths
- **Chat/run**: Use Mythos as the agent interface with a configured provider key.
- **Skills**: Store repo-local or personal SKILL.md rule packs and load them into chat/run.
- **MCP adapter**: Run `mythos mcp` so MCP clients can call SWD dry-run/apply, receipts, and skill checks.
- **External-agent SWD**: Pipe structured file actions into `mythos swd apply --stdin --json` for lower-level automation without a Mythos model call.
- **Receipts**: Inspect verified file changes, hashes, provider or external-agent metadata, rollback state, and drift checks.

## Getting started
- Install globally: `npm install -g mythos-router`
- Check setup: `mythos init --check`
- One-shot task: `mythos run "explain this repo"`
- Generate repo skill: `mythos learn`
- MCP tool server: `mythos mcp`
- Direct external-agent boundary: `cat actions.json | mythos swd apply --stdin --json`

For `mythos chat` and `mythos run`, configure at least one supported provider key. For `mythos mcp` and `mythos swd apply`, Mythos does not call a model in the file-apply path because the external agent brings its own model.

## Links
- Docs: https://mythosrouter.com/docs
- Start guide: https://mythosrouter.com/docs?topic=start
- MCP / external agents: https://mythosrouter.com/docs?topic=external
- Contract Address (CA): `0xb942b75a602fa318ac091370d93d9143ba345ba3`
- GitHub: https://github.com/thewaltero/mythos-router
