How vectorize-io/self-driving-agents works
Self-Driving Agents packages reusable agent templates and a CLI that installs them into supported chat runtimes, with Hindsight providing portable memory. The main user journey is to choose a built-in or local/GitHub agent, select a harness, install its template and runtime configuration, then use the agent in conversation. The repository also includes a website for browsing templates and comparing harnesses, plus a Hermes tool plugin. Edges are limited to relationships shown in excerpts or documented in the README; unsampled harness setup details are not expanded.
Main entry points: cli.ts Install CLI · harnesses.ts Harness runtimes · agents.ts Agent catalog data · page.tsx Website pages
Components 17
Installation
- Install CLI
src/cli.ts
Agent Catalog
- Agent sources
- Department templates
engineering - Bank templates
engineering/bank-template.json - Agent skill
src/skill/SKILL.md
Runtime Memory
- Harness runtimes
website/src/lib/harnesses.ts - Hindsight memory
- Hermes tools
hermes-plugin/__init__.py
Catalog Website
- Website pages
website/src/app/page.tsx - Agent browsing
website/src/app/agents/page.tsx - Agent details
website/src/app/agents/[...slug]/page.tsx - Agent catalog data
website/src/lib/agents.ts - Harness guides
website/src/app/harnesses/page.tsx - Harness details
website/src/app/harnesses/[slug]/page.tsx - Memory concept
website/src/app/concept/page.tsx - Agent creation guide
website/src/app/create/page.tsx
Other components
- Agent user
Connections 14
- Agent user → Install CLI: runs install
README.md - Install CLI → Agent sources: resolves source
README.md - Agent sources → Department templates: includes templates
README.md - Department templates → Bank templates: defines bank
- Install CLI → Harness runtimes: configures harness
README.md - Install CLI → Hindsight memory: imports bank
src/cli.ts - Install CLI → Agent skill: installs skill
- Hermes tools → Hindsight memory: calls API
- Website pages → Agent catalog data: loads agents
website/src/app/page.tsx - Agent browsing → Agent catalog data: loads and flattens
website/src/app/agents/page.tsx - Agent details → Agent catalog data: finds agent
website/src/app/agents/[...slug]/page.tsx - Website pages → Harness runtimes: lists harnesses
website/src/app/page.tsx - Harness guides → Harness runtimes: lists harnesses
website/src/app/harnesses/page.tsx - Harness details → Harness runtimes: loads details
website/src/app/harnesses/[slug]/page.tsx