@vibetown/cli
v0.2.4
Published
Vibetown CLI — installs as a Claude Code / Codex PostToolUse hook to stream file-change events to your Vibetown city.
Readme
@vibetown/cli
Global CLI that hooks into Claude Code's and Codex's PostToolUse event and
forwards file-change activity to your Vibetown city.
Install (once published)
npm install -g @vibetown/cli
vibetown login
vibetown setup # interactive: pick Claude Code and/or CodexWire up the hook
Run vibetown setup and pick the agents you want to wire up. Non-interactively:
vibetown setup --claude --codex # both, user level
vibetown setup --claude --project # claude, project-local .claude/
vibetown setup --codex --remove # uninstall from codexThe setup writes to:
~/.claude/settings.json(or./.claude/settings.jsonwith--project)~/.codex/hooks.json(or./.codex/hooks.jsonwith--project)
The hook reads the PostToolUse JSON from stdin, walks up to find a .git
directory, checks whether origin points at a GitHub repo registered with
Vibetown, and if so calls the record_change reducer on the SpacetimeDB
module.
Commands
| Command | Purpose |
| ------------------ | ------------------------------------------------------- |
| vibetown login | Authenticate via SpacetimeDB-Auth (GitHub). |
| vibetown status | Show current config / token state. |
| vibetown init | Print info needed to register the current repo as a city. |
| vibetown setup | Install or remove the PostToolUse hook in Claude Code / Codex. |
| vibetown hook | Internal: process a PostToolUse event from stdin. |
