How taewooopark/motifcode works
Motifcode is a Motif-3-specific terminal coding-agent harness. The principal workflow starts at the CLI, opens an interactive chat, runs the model/tool loop, and presents results in the terminal UI. Separate branches cover configuration and login, MCP integrations, session persistence, subagents and skills, and evaluation. Edges reflect README statements or source-index references and excerpts; unsampled implementation details are not inferred.
Main entry points: chat.ts Interactive chat · main.ts CLI entry · manager.ts MCP manager · loop.ts Agent loop
Components 23
CLI and session
- CLI entry
packages/cli/src/main.ts - Interactive chat
packages/cli/src/chat.ts - Slash commands
packages/cli/src/commands.ts - Login and keys
packages/cli/src/login.ts - Settings
packages/cli/src/settings.ts - Project files
packages/cli/src/files.ts - Session journal
packages/journal/src/index.ts
Agent runtime
- Agent loop
packages/core/src/loop.ts - Context ledger
packages/core/src/session.ts - Tool execution
packages/cli/src/executor.ts - Permission policy
packages/cli/src/policy.ts - Model protocol
packages/protocol/src/toolcall.ts
Tools and integrations
- Skills
packages/skills/src/builtin.ts - Subagents
packages/agents/src/index.ts - MCP configuration
packages/mcp/src/config.ts - MCP manager
packages/mcp/src/manager.ts - MCP connection
packages/mcp/src/client.ts - MCP OAuth
packages/mcp/src/auth.ts
Terminal experience
- Terminal interface
packages/tui/src/screen.ts - Diagnostics
packages/cli/src/doctor.ts - Usage insights
packages/cli/src/insights.ts
Model fit and evaluation
- Agent evaluation
packages/eval/src/suite-cli.ts
Other components
- Developer
Connections 25
- Developer → CLI entry: starts
README.md - CLI entry → Interactive chat: opens session
packages/cli/src/main.ts - CLI entry → Login and keys: handles sign-in
packages/cli/src/main.ts - CLI entry → MCP configuration: loads config
packages/cli/src/main.ts - Interactive chat → Agent loop: runs
packages/cli/src/chat.ts - Interactive chat → Slash commands: parses commands
packages/cli/src/chat.ts - Interactive chat → Terminal interface: updates interface
packages/cli/src/chat.ts - Interactive chat → Session journal: persists session
- Interactive chat → Skills: uses skills
packages/cli/src/chat.ts - Interactive chat → MCP manager: uses MCP context
packages/cli/src/chat.ts - Agent loop → Context ledger: manages context
packages/core/src/loop.ts - Agent loop → Model protocol: uses tool parsing
- Interactive chat → Tool execution: dispatches tools
packages/cli/src/chat.ts - Tool execution → Permission policy: applies policy
packages/cli/src/executor.ts - Tool execution → Skills: uses skills
packages/cli/src/executor.ts - Interactive chat → Subagents: supports delegation
- MCP manager → MCP configuration: resolves servers
packages/mcp/src/manager.ts - MCP manager → MCP connection: opens connection
packages/mcp/src/manager.ts - MCP manager → MCP OAuth: uses broker
packages/mcp/src/manager.ts - MCP connection → MCP OAuth: authorizes access
packages/mcp/src/client.ts - CLI entry → Diagnostics: runs diagnostics
packages/cli/src/main.ts - CLI entry → Settings: handles settings
packages/cli/src/main.ts - Interactive chat → Project files: uses project files
packages/cli/src/chat.ts - CLI entry → Usage insights: offers insights
- Agent evaluation → Agent loop: evaluates runs
packages/eval/src/suite-cli.ts