How hoangp8/tokless works
Tokless is a Go CLI that configures and manages coding-agent integrations: users select supported agents, Tokless wires specialized tools into their configurations, and commands support diagnosis, updates, and proxy routing. Its principal workflow runs through the CLI into command handlers and agent/tool adapters. Tool-specific modules cover RTK, CodeGraph, Context Mode, and other documented capabilities; Headroom adds shared proxy routing and BYOK support. The README documents broad integrations, while several subsystem links below are documented rather than verified from unsampled implementation.
Main entry points: core.go Tool registry · agents Agent adapters · main.go Tokless CLI · proxy.go Proxy commands
Components 16
CLI management
- Tokless CLI
cmd/tokless/main.go - Command handlers
internal/commands - Tool registry
internal/core/core.go
Agent integrations
- Agent adapters
internal/agents - Agent configurations
internal/agents/codex.go
Tool integrations
- RTK filtering
internal/tools/rtk.go - CodeGraph indexing
internal/tools/codegraph.go - Context Mode
internal/tools/contextmode.go - Other tools
internal/tools - Headroom integration
internal/tools/headroom.go
Proxy routing
- Proxy commands
internal/commands/proxy.go - Headroom proxy
internal/headroom/proxy.go - Request router
internal/headroom/router.go - BYOK gateway
internal/headroom/byok_gateway.go - Route state
internal/util/routing_store.go
Other components
- Operator
Connections 20
- Operator → Tokless CLI: invokes
- Tokless CLI → Command handlers: dispatches
cmd/tokless/main.go - Tokless CLI → Tool registry: registers tools
cmd/tokless/main.go - Command handlers → Agent adapters: configures agents
internal/commands/proxy.go - Command handlers → Tool registry: lists tools
internal/commands/index.go - Agent adapters → Agent configurations: edits settings
- Tool registry → RTK filtering: registers
- Tool registry → CodeGraph indexing: registers
- Tool registry → Context Mode: registers
internal/tools/contextmode.go - Tool registry → Other tools: registers
internal/tools/contextmode.go - RTK filtering → Agent adapters: wires into
internal/tools/rtk.go - CodeGraph indexing → Agent adapters: configures MCP
internal/tools/codegraph.go - Operator → Proxy commands: requests routing
- Tokless CLI → Proxy commands: dispatches
cmd/tokless/main.go - Proxy commands → Headroom proxy: starts and stops
internal/commands/proxy.go - Proxy commands → Agent adapters: wires proxy
internal/commands/proxy.go - Headroom integration → Headroom proxy: integrates
- Headroom proxy → Request router: serves routes
- Request router → Route state: resolves route
- Headroom proxy → BYOK gateway: supports BYOK