@tytybill123/agent-bootstrap

Portable CLI for bootstrapping coding projects into an Obsidian-backed AI memory kit with a Codex-native workspace.

Public Flow

The user-facing flow is intentionally small:

1. Install or update the CLI
2. Set the Obsidian vault path
3. Initialize a project
4. Update an existing project's kit files
5. Uninstall when no longer needed

AI context commands still exist, but generated AGENTS.md files tell AI agents to run compact context automatically.

1. Install Or Update CLI

npm i -g --force @tytybill123/agent-bootstrap

2. Set Vault

Run once per machine, pointing at your Obsidian vault root:

agent-bootstrap setup "D:\project\nodejs\NodeVault"

If your terminal is already inside the vault folder:

agent-bootstrap setup

3. Init Project

agent-bootstrap init "D:\project\nodejs\srcEcommerce" --type fullstack
agent-bootstrap init "D:\project\nodejs\frontend-app" --type frontend
agent-bootstrap init "D:\project\nodejs\backend-service" --type backend

Available project types:

• frontend: UI routes, state, browser behavior, deployment surface
• backend: handlers, contracts, auth, persistence, service rollout
• fullstack: frontend, backend, database, shared contracts, deploy topology
• tool: CLI, scripts, filesystem effects, config, external command behavior
• desktop: shell, windows, IPC, filesystem access, packaging
• mobile: navigation, device permissions, offline sync, release channels

If --type is omitted, the default is tool.

init creates:

• root AGENTS.md
• .codex/ with Codex config, custom subagents, command templates, and 2 core skills
• docs/vault-memory.md and docs/project-map.md
• plans/
• vault.config.json
• scripts/agent-memory.js
• .githooks/post-commit
• vault project capsule under Projects/<slug>
• Tasks.md, Decisions.md, Facts.md, Open Questions.md, and Handoff.md

Existing repo README.md files are preserved.

4. Update Project Kit

After installing a newer CLI version, refresh a project that is already being built:

agent-bootstrap update "D:\project\nodejs\srcEcommerce"

update refreshes kit-managed .codex assets, AGENTS.md managed block, docs bridge, runtime script, manifest, and kit version metadata. It preserves project source code, the root README, vault.config.json identity fields, and vault memory.

Legacy .agent, .agents, and old .github/agents|commands|rules|skills|prompts assets are removed so AI agents do not read stale instructions.

5. Uninstall CLI

npm uninstall -g @tytybill123/agent-bootstrap

Optional: AI Context

Users can run these manually. AI agents should run it automatically from AGENTS.md:

agent-bootstrap context --compact
agent-bootstrap context --why
agent-bootstrap context --full

• --compact loads the smallest useful repo and vault context
• --why explains what was loaded and skipped
• --full adds daily/session history when needed

Codex Workspace

Generated projects use .codex/:

• config.toml: default [agents] max_threads = 6 and max_depth = 1
• agents/*.toml: Codex custom agents
• commands/: agent-bootstrap managed prompt templates, not native Codex slash commands
• skills/: lazy-loaded workflow and coding discipline
  • .codex/skills/superpowers/: workflow discipline
  • .codex/skills/karpathy-coding-principles/: coding discipline

Shipped core skills:

• superpowers: workflow priority top 1
• karpathy-coding-principles: coding mindset top 2

Frontend, backend, cloud, database, CI, provider, and framework-specific work is handled through repo context, the relevant subagent when delegation helps, and current official docs when API details matter.

There is no rules/ folder. Always-on guardrails live in AGENTS.md, .codex/INDEX.md, and .codex/skills/INDEX.md.

Vault Bridge

The vault bridge is stable across init and update:

• vault.config.json links repo, vault, project slug, project type, and kit version
• agent-bootstrap context --compact loads repo context, vault context, and project memory index
• scripts/agent-memory.js writes tasks, decisions, facts, questions, handoffs, research, notes, and compact summaries
• Facts.md is for source-backed facts
• Open Questions.md is for unresolved assumptions
• Handoff.md keeps the next-session state short

Contributor Verification

npm test