How spenceriam/impulse works
Impulse is a provider-flexible terminal coding agent. The principal workflow starts in the interactive terminal, sends user turns through the agent’s tool-execution loop and configured model provider, then presents responses and tool results in the terminal while retaining session history. Separate branches cover shell and web research, vision, planning/advisor workflows, parallel tasks, and session management. The graph combines README capability statements with the supplied excerpts and SOURCE INDEX; links to unsampled subsystems are included only where documented, and evidence limits leave some internal calls unspecified.
Main entry points: loop.ts Agent turn loop · api/manager.ts Provider routing · session/manager.ts Session lifecycle · registry.ts Tool registry
Components 26
Terminal experience
- CLI startup
src/index.ts - Terminal renderer
src/cli/renderer.ts - Prompt input
src/cli/prompt-input.ts - Slash commands
src/cli/slash-dispatch.ts
Agent workflows
- Agent turn loop
src/agent/loop.ts - Tool orchestrator
src/agent/orchestrator.ts - Advisor workflow
src/agent/advisor.ts - Vision routing
src/api/vision-probe.ts - Parallel subagents
src/tools/task.ts
Model connectivity
- Provider routing
src/api/manager.ts - Provider interface
src/api/provider.ts - Provider adapters
src/api/providers/ollama.ts - Model capabilities
src/api/capabilities.ts
Sessions and state
- Configuration
src/util/config.ts - Session lifecycle
src/session/manager.ts - Session store
src/session/store.ts - Context compaction
src/session/compact.ts - Resume marker
src/util/active-session-marker.ts - Event bus
src/bus/bus.ts - Storage backend
src/storage/storage.ts
Tools and permissions
- Tool registry
src/tools/registry.ts - Tool guidance
src/tools/tool-notes.ts - Permission handling
src/permission/index.ts - Shell commands
src/tools/bash.ts - Web research
src/tools/web-search.ts
Other components
- Developer
Connections 27
- Developer → CLI startup: starts
README.md - CLI startup → Terminal renderer: starts interface
src/index.ts - Developer → Prompt input: enters turns
README.md - Prompt input → Agent turn loop: submits turn
- Terminal renderer → Agent turn loop: presents agent workflow
- Agent turn loop → Provider routing: requests model
- Provider routing → Configuration: loads configuration
src/api/manager.ts - Provider routing → Provider adapters: registers providers
src/api/manager.ts - Provider adapters → Provider interface: implements interface
src/api/providers/ollama.ts - Provider routing → Model capabilities: routes capabilities
- Agent turn loop → Tool orchestrator: dispatches tools
- Tool orchestrator → Tool registry: uses registry
src/agent/orchestrator.ts - Tool registry → Tool guidance: loads guidance
src/tools/registry.ts - Tool registry → Shell commands: offers command tool
- Tool registry → Web research: offers research tools
src/tools/web-search.ts - Agent turn loop → Permission handling: requests approval
- Developer → Slash commands: issues commands
README.md - Slash commands → Session lifecycle: manages sessions
- Session lifecycle → Session store: reads and writes
src/session/manager.ts - Session lifecycle → Resume marker: updates resume marker
src/session/manager.ts - Session lifecycle → Context compaction: compacts context
src/session/manager.ts - Session store → Storage backend: uses storage
src/session/store.ts - Session store → Event bus: publishes events
src/session/store.ts - Agent turn loop → Advisor workflow: supports advisor mode
README.md - Agent turn loop → Vision routing: routes image input
README.md - Agent turn loop → Parallel subagents: runs parallel tasks
README.md - Shell commands → Developer: shows command output
README.md