hanzoai/bot
2
0
Fork 0
mirror of https://github.com/hanzoai/bot.git synced 2026-10-30 17:24:26 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
bot/docs/start/bootstrapping.md
T
zeekayandHanzo Dev 84e4069c2c docs name the state dir and config file the bot reads: ~/.bot/bot.json 
The docs said ~/.hanzo-bot/hanzo-bot.json (and ~/.hanzo-bot-<profile>, hanzo-bot.plugin.json), which nothing reads: src/config/paths.ts resolves ~/.bot, bot.json and ~/.bot-<profile>, and plugins ship bot.plugin.json. Every such path in docs/ now names what the code opens.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-24 21:12:09 -07:00

1.3 KiB
Raw Permalink Blame History

summary, read_when, title, sidebarTitle
summary read_when title sidebarTitle
Agent bootstrapping ritual that seeds the workspace and identity files
Understanding what happens on the first agent run
Explaining where bootstrapping files live
Debugging onboarding identity setup
Agent Bootstrapping Bootstrapping

Agent Bootstrapping

Bootstrapping is the first‑run ritual that prepares an agent workspace and collects identity details. It happens after onboarding, when the agent starts for the first time.

What bootstrapping does

On the first agent run, HanzoBot bootstraps the workspace (default ~/.bot/workspace):

  • Seeds AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md.
  • Runs a short Q&A ritual (one question at a time).
  • Writes identity + preferences to IDENTITY.md, USER.md, SOUL.md.
  • Removes BOOTSTRAP.md when finished so it only runs once.

Where it runs

Bootstrapping always runs on the gateway host. If the macOS app connects to a remote Gateway, the workspace and bootstrapping files live on that remote machine.

When the Gateway runs on another machine, edit workspace files on the gateway host (for example, `user@gateway-host:~/.bot/workspace`).

Related docs

Reference in New Issue View Git Blame Copy Permalink