How yanghoeg/usix-termux works
usix-code is a local coding and automation harness for Linux and Android Termux. Users submit prompts through the CLI/TUI; the agent consults a local model, dispatches registered tools, and pauses for approval before mutations. A separate task workflow saves, schedules, and runs prompts, with checkpoints and approval handling. Host adapters supply OS-specific tools and services; optional Termux capabilities include messaging, email, UI control, and companion-app access. The README documents the hexagonal boundaries; unsampled implementation details and some runtime wiring are not asserted here.
Main entry points: agent.rs Agent loop · ports.rs Core ports · termux.rs Termux host · tui.rs Interactive TUI
Components 29
User interaction
- CLI entry
src/main.rs - Interactive TUI
src/tui.rs - Input editor
src/tui/editor.rs - Markdown rendering
src/tui/markdown.rs
Agent core
- Agent loop
src/domain/agent.rs - Tool registry
src/domain/registry.rs - Skill selection
src/domain/skills.rs - Core ports
src/ports.rs
Tasks and tools
- Task commands
src/tasks/mod.rs - Task runner
src/tasks/runner.rs - Saved task state
src/tasks/store.rs - Local tools
src/tools/shell.rs - Task tools
src/tools/tasks.rs
Host and model adapters
- Setup and lifecycle
src/bootstrap.rs - Host selection
src/adapters/host/mod.rs - Linux host
src/adapters/host/linux.rs - Termux host
src/adapters/host/termux.rs - Skill file I/O
src/adapters/skills.rs - Process runtime
src/adapters/runtime.rs - llama.cpp adapter
src/adapters/llama.rs - Ollama adapter
src/adapters/ollama.rs
Device integrations
- Phone tools
src/tools/comms.rs - Companion tools
src/tools/companion.rs - Companion bridge client
src/tools/bridge.rs - Android UI tools
src/tools/ui.rs - Email tools
src/tools/email.rs
Other components
- User
- Local model service
- Companion app
Connections 38
- User → CLI entry: submits commands
README.md - CLI entry → Host selection: selects host
src/main.rs - CLI entry → Interactive TUI: starts chat
src/main.rs - User → Interactive TUI: enters prompts
README.md - Interactive TUI → Input editor: uses editor
src/tui.rs - Interactive TUI → Markdown rendering: renders answers
src/tui.rs - Interactive TUI → Agent loop: advances turns
src/tui.rs - Agent loop → Tool registry: looks up tools
src/domain/agent.rs - Agent loop → Core ports: uses LLM contract
src/domain/agent.rs - Agent loop → Skill selection: selects guidance
README.md - Tool registry → Core ports: registers tools
src/domain/registry.rs - CLI entry → Task commands: routes task commands
src/main.rs - Task commands → Saved task state: manages saved tasks
src/tasks/mod.rs - Task commands → Task runner: runs tasks
src/tasks/mod.rs - Task runner → Saved task state: loads checkpoints
src/tasks/runner.rs - Task runner → Agent loop: resumes agent
src/tasks/runner.rs - Task tools → Saved task state: reads and changes tasks
src/tools/tasks.rs - Host selection → Linux host: selects on Linux
src/adapters/host/mod.rs - Host selection → Termux host: selects on Android
src/adapters/host/mod.rs - Termux host → Phone tools: registers phone tools
src/adapters/host/termux.rs - Termux host → Companion tools: registers companion tools
src/adapters/host/termux.rs - Termux host → Android UI tools: registers UI tools
src/adapters/host/termux.rs - Termux host → Email tools: registers email tools
src/adapters/host/termux.rs - Companion tools → Companion bridge client: uses bridge client
src/tools/companion.rs - Email tools → Companion bridge client: uses bridge client
src/tools/email.rs - Android UI tools → Companion bridge client: uses bridge client
src/tools/ui.rs - Companion bridge client → Companion app: sends loopback requests
src/tools/bridge.rs - Setup and lifecycle → Host selection: uses host services
src/bootstrap.rs - Setup and lifecycle → Core ports: uses host contracts
src/bootstrap.rs - Skill file I/O → Skill selection: parses skill files
src/adapters/skills.rs - Process runtime → Core ports: implements runtime I/O
src/adapters/runtime.rs - llama.cpp adapter → Core ports: implements LLM port
src/adapters/llama.rs - Ollama adapter → Core ports: implements LLM port
src/adapters/ollama.rs - Setup and lifecycle → llama.cpp adapter: starts selected backend
src/bootstrap.rs - Setup and lifecycle → Ollama adapter: starts selected backend
src/bootstrap.rs - llama.cpp adapter → Local model service: calls local model
- Ollama adapter → Local model service: calls local model
- Agent loop → Local tools: dispatches registered tools