A personal Pi setup with bundled extensions, skills and prompts. Features include browser tools, background subagents, voice, image generation, fast mode, context tools and Anthropic request compression. Amp orbs are optional.

Install Node through nvm, using the major version in .node-version. Then clone the repository, install the pinned Pi version and load the package:

mkdir -p ~/projects
git clone https://github.com/tmustier/vibes.git ~/projects/vibes
cd ~/projects/vibes
npm ci --omit=dev --ignore-scripts
npm install -g --ignore-scripts \
  --before "$(node -p 'require("./package.json").piDependencyCutoff')" \
  "@earendil-works/pi-coding-agent@$(node -p 'require("./package.json").devDependencies["@earendil-works/pi-coding-agent"]')"
pi install "$HOME/projects/vibes"
pi

Run /onboard in Pi. It preserves your settings and credentials, applies the initial profile in profiles/home.vibes.json, offers the nightly updater and checks startup and real tool use. The setup uses openai-codex and anthropic logins. Connect your own accounts and keep credentials and MCP configuration outside Git.

Your choices live in ~/.pi/agent/vibes.json:

{ "features": { "surf": false, "cachemire": true } }

Run vibes features to list feature names and defaults. The initial home profile is not an overwrite policy: later choices stay yours. Dependencies remain installed when their features are off.

An optional skill reviews an internal team meeting from its transcript: your own part, where the conversation got stuck and what was left without a decision or an owner. To use it, add the path of optional-skills/internal-meeting-review in your clone to skills in ~/.pi/agent/settings.json and run /reload. It reads a transcript file or a Granola meeting.

See existing setups, fast mode and the package guides for browser tools and request compression.

Ask Pi to publish a page on claude.ai, update an existing artifact, read its comments or use its shared database. The tools load when needed and require Claude Code on PATH, signed in with claude auth login to an account with artifacts enabled. Without Claude Code, the feature adds nothing.

Set "claude-artifacts": false in your feature choices to disable it. See Claude artifact tools for details and limitations, or existing setups if you used the old publishing skill.

Vibes bundles pi-claude-code. vibes update and /onboard install Claude Code if it is missing. Run claude auth login, check /claude-code-status in Pi, then select a model from Claude Code Subscription (Experimental). Your current model selection stays unchanged. Usage counts against your Claude subscription; upstream warns that billing may change.

Set "claude-code": false in your feature choices to disable the provider and skip the CLI installation.

Parking is optional and needs the launcher as well as the extension. To enable it, add this alias to ~/.zshrc, adjusting the path if your clone lives elsewhere:

alias pi="$HOME/projects/vibes/scripts/pi-park"

Open a new terminal and run pi --help to check for --park-after. /park parks a session, and a keypress resumes it. /reload cannot add the launcher to an existing session.

~/.local/bin/vibes points to scripts/home-vibes in your clone. vibes update fast-forwards from this repository, installs dependencies, updates unchanged template settings, keeps Pi at the tested version, refreshes the model registry and runs vibes check. It does not merge another repository or push commits. A dirty or diverged checkout needs manual review.

The home updater writes ~/.pi/agent/vibes-update.json with updater: "home", a success or failure result and step details, plus a personal update log. vibes status shows the structured result and launchd state. The update-status extension warns about failed or stale updates and recommends vibes update, not managed refresh. Home repairs stay local, create no central report and do not ask you to synchronize an AGENTS template.

scripts/home-install-job installs the optional nightly macOS update job. The home command does not run managed refresh or hotfix jobs, update other workspaces or install upload jobs. vibes chatgpt-update is a separate opt-in command for the ChatGPT for Work app that Computer Use needs; see existing setups before running it.

vibes check starts Pi in a hidden tmux session. Behaviour changes also need a real prompt and tool call. If Granola times out despite a valid login, see the compatibility fix.

Codex Conversion 4.0.5 removes its built-in Notes/history and legacy Remote mode. Existing Notes configurations can block turns, including in voice-only mode. Follow the upgrade message: install and enable @howaboua/pi-notes-compaction, or explicitly choose ordinary compaction in the indicated configuration file. The updater does not make that choice for you.

There is no default telemetry destination. Inventory and usage tools can collect local data; remote uploads require an explicitly configured destination. Inventory can include the text of your own extensions, skills and prompts. Review it before choosing a destination, and use a private repository or receiver. See telemetry destinations and usage telemetry. Set "vibesTelemetry": false in personal settings to disable collection and uploads.

Papercut notes stay local by default. Publishing this repository does not make it an inbox for private setup data or workflow notes. /papercuts-review reviews local notes; any remote submission is a separate, explicit action.

MIT. Third-party code and dependencies retain their own license terms.