What do you want to do?¶

[!IMPORTANT] Work in progress — not a final product: vibey is under active development and is not yet a final product. Capabilities and outcomes documented here reflect our living, evolving system. Folks will be notified on the Discord server once the product is finally done.

Bottom Line Up Front (BLUF) — Need to install vibey or any krypton app first?

• One-line install (vibey engine + krypton browser launcher on macOS & Linux): bash curl -fsSL https://raw.githubusercontent.com/the-vibey-project/vibey/main/scripts/install.sh | sh -s -- --with-krypton vibey connect --yes # plug vibey into Claude Code, Codex, Cursor, VS Code, Claude Desktop & Gemini CLI
• Install every krypton interface (Desktop on macOS & Linux, VS Code / VSCodium / Cursor extension, Web app, and Android & iOS mobile apps): Follow the step-by-step beginner guide in Install, copy, reinstall, uninstall and Downloads.

You probably arrived with a problem rather than a wish to learn a new tool: code that must not leave your machine, an agent bill nobody can explain, an auditor asking what the agent did. Each guide below answers one such question. It opens with a one-sentence answer, then gives the commands, then links the code, tests and decisions that prove each claim, then says plainly where vibey stops. Each reads in under five minutes.

Use it¶

• How do I run AI coding agents entirely on my own hardware? Run vibey on its default engine, GPT-OSS 20B on Ollama, and allow only that engine; the queue, the ledger and the model then stay on one machine.
• How do I cap what AI coding agents spend, and see where the money went? Set a per-cycle dollar or turn cap with vibey budget set; the brake parks a gate when it trips, and vibey cost shows each engine's spend.

Run it for a team¶

• How do I keep a tamper-evident record of everything an AI agent did? Every decision, answer, handoff and cost goes into a PostgreSQL ledger the application cannot rewrite, and each export walks a SHA-256 chain over it.
• How do I review an AI-built change before it can merge? A REVIEW gate waits for your verdict, and vibey-gh merges a pull request only on checks that passed on its exact head commit.
• Can an AI agent deploy my software without holding cloud secrets? Partly, and not yet for production: the opt-in Azure stages keep no credential and change nothing until you consent, but they are not yet proven against real Azure.

Assess it¶

• Can I use vibey in a regulated environment? A checklist of the mechanisms an assessor asks about, each with its evidence, and a plain list of what vibey does not provide. It is not a certification.

Your question is not here?¶

Ask it in Discussions. A question two people ask is a guide worth writing, and writing one is a good first contribution: copy the shape of any page above, and follow your first hour from a fork to a pull request. ADR-0077 says what every guide must contain.