Self-Driving Agents

Agents that learn from every conversation and get better over time.

No retraining, no manual updates — just use them and they improve. Powered by Hindsight, so agent memory is portable across harnesses.

📖 Docs: https://vectorize-io.github.io/self-driving-agents/

Quick start

Claude Chat / Cowork

npx @vectorize-io/self-driving-agents install marketing/seo --harness claude

The CLI prompts for your Hindsight connection (Cloud or self-hosted), creates a skill zip, and tells you how to upload it. Then type /<agent-name> in any conversation to activate the agent.

OpenClaw

npx @vectorize-io/self-driving-agents install marketing/seo --harness openclaw

NemoClaw

npx @vectorize-io/self-driving-agents install marketing/seo --harness nemoclaw

That's it. The CLI fetches the agent from this repo, sets up its memory bank, ingests the seed knowledge, and registers it with your harness. Follow the on-screen instructions to start chatting.

You can also point at a local directory or any GitHub repo:

npx @vectorize-io/self-driving-agents install ./my-agent --harness claude
npx @vectorize-io/self-driving-agents install my-org/my-repo/my-agent --harness openclaw

Or start with a blank agent — no template, no seed content — using --empty:

npx @vectorize-io/self-driving-agents install my-agent --harness claude-code --empty

The first positional becomes the agent name. The CLI provisions the bank, sets up the harness, and lets you build everything up from the conversation.

How it works

1. You chat with the agent
2. Conversations are automatically retained into memory
3. The agent builds knowledge pages that update themselves after each conversation
4. Next session, the agent reads its updated pages — it remembers what works and what you prefer

You never tell it to "save" or "remember." It decides what matters and keeps itself current.

Available agents

marketing/

Full marketing team — install the whole department or pick a specialty.

| Install | What you get | |---------|-------------| | marketing | Generalist — all 30 agent knowledge files across every specialty | | marketing/seo | SEO specialist, search optimizer, citation strategist | | marketing/social-media | Platform strategists for TikTok, Instagram, LinkedIn, X, Reddit | | marketing/content | Content creator, growth hacker, book co-author | | marketing/ecommerce | Cross-border commerce, livestream selling | | marketing/china-market | WeChat, Douyin, Xiaohongshu, Baidu, Bilibili |

Create your own

An agent is just a directory:

my-agent/
  bank-template.json     # optional — configures memory bank and knowledge pages
  seo-playbook.md        # any .md/.txt files become seed knowledge
  advanced-tips.md

Nest directories for multi-level agents:

my-team/
  bank-template.json     # install my-team → everything below
  specialist-a/
    bank-template.json   # install my-team/specialist-a → just this
    reference.md
  specialist-b/
    bank-template.json
    guide.md

Content files are discovered recursively. Each level can have its own bank-template.json with a tailored mission and knowledge pages.

What install does

The CLI is a single setup command — no manual steps required. Here's what happens:

1. Fetches the agent — downloads the directory from GitHub (or uses a local path)
2. Configures connection — prompts for Hindsight Cloud or self-hosted API URL and token
3. Connects to Hindsight and imports the bank-template.json (memory bank config, knowledge pages, directives)
4. Ingests all content files (.md, .txt, etc.) found recursively as seed knowledge
5. Generates the agent — creates a skill (Claude) or workspace (OpenClaw/NemoClaw) with the knowledge tools baked in

Claude harness

For Claude Chat and Cowork, the CLI generates a self-contained skill zip:

• The agent's Hindsight API URL, bank ID, and token are baked directly into the skill
• No external dependencies — uses curl to call the Hindsight REST API
• The skill instructs Claude to load knowledge pages at startup, retain user feedback during conversations, and manage pages
• Upload the zip via Customize → Skills → Upload in Claude Chat or Cowork
• After upload, allowlist the API host in Settings → Capabilities
• Type /<agent-name> in any conversation to activate

OpenClaw / NemoClaw harness

For OpenClaw and NemoClaw, the CLI installs the Hindsight plugin, creates a workspace, and registers the agent with the harness. Restart the gateway and start chatting.

Supported harnesses

| Harness | Flag | Status | |---------|------|--------| | Claude Chat | --harness claude | Supported | | Claude Cowork | --harness claude | Supported | | OpenClaw | --harness openclaw | Supported | | NemoClaw | --harness nemoclaw | Supported |

Requirements

• A supported harness
• A Hindsight account (Cloud or self-hosted)
• Everything else is handled by the CLI