Get started with the CLI
Install the dibbla CLI, run dibbla init, and let your code agent drive it.
The dibbla CLI is the primary way to ship code, manage applications, databases, secrets, and workflows on Dibbla. Pick the install method for your platform — all install the same binary.
Install
# macOS / Linux $curl https://install.dibbla.com -fsS | sh
# Windows $irm https://install.dibbla.com/install.ps1 | iex
# macOS / Linux $brew install dibbla-agents/tap/dibbla
You can also grab a binary directly from GitHub Releases.
First-time setup
Run dibbla init inside any project directory. It’s a one-shot wrapper that gets you all the way to “shipping” in three guided steps — updating the binary, signing in, and installing the AI-agent skill so your editor can drive Dibbla for you.
$dibbla init ✦ Step 1/3: Updating dibbla to the latest version already on latest (1.2.33) ✦ Step 2/3: Logging in to Dibbla ? How would you like to log in? ▸ Log in with browser Paste an API token 🌐 Opening browser for login... ✅ Logged in to https://api.dibbla.com ✦ Step 3/3: Installing dibbla skill into current project writing .claude/skills/dibbla/SKILL.md writing .claude/skills/dibbla/guardrails.md writing .claude/skills/dibbla/user-docs.md … ten files in total updated AGENTS.md updated GEMINI.md ✓ Setup complete. Open your AI code agent in this folder and ask it to build and deploy your app.
Each step also runs as a standalone command — dibbla update, dibbla login, dibbla skills install dibbla. The login step is skipped if you already have
a token; pass --re-login to force it. The skill step is best-effort — if it
fails, the CLI continues. Use --user to install the skill into $HOME
instead of the current project (one install, every project on this machine).
Set up your code agent
dibbla init’s third step installs the Dibbla skill — a small bundle of Markdown that teaches your AI coding agent how to drive dibbla on your behalf. Pick your agent below to see what changed in your project and how to use it.
Claude Code reads skills from .claude/skills/. After dibbla init, your project has:
.claude/skills/dibbla/
├── SKILL.md ← entry point Claude Code reads first
├── guardrails.md ← the pre-deploy checklist, and when to ask first
├── user-docs.md ← how to write the handbook a deploy requires
├── examples.md ← copy-pasteable workflows
├── reference.md ← full command surface
├── manifest.md ← dibbla.yaml, for multi-service apps
├── platform.md ← what the platform gives a running app
├── workflows.md ← workflows and pipelines
├── sdk-go.md ← the Go SDK for workers
└── ai-gateway.md ← calling models without provider keysOpen the project in Claude Code and describe what you want built. The skill is what turns “deploy this” into the right sequence of commands:
Read the dibbla skill. Build me a small app that tracks which of our
internal tools are down, backed by a Dibbla Postgres database, then
prepare it for deploy and deploy it.Claude will pick up the skill on the next session — no extra wiring.
Cursor reads AGENTS.md at the project root (open standard). dibbla init either created that file or merged a marker-delimited block into your existing one — your own content is preserved.
Restart your Cursor session (or open a new chat) and try:
Use the dibbla skill to deploy this directory as a new app.Cursor’s agent will load the AGENTS.md context and use the skill’s reference + examples.
Gemini CLI reads GEMINI.md at the project root. dibbla init wrote (or merged into) that file with the skill’s full context.
Run gemini inside your project and try:
Use the dibbla skill to deploy this directory as a new app.Gemini will index GEMINI.md on startup and follow the skill’s instructions.
Opencode reads AGENTS.md at the project root (open standard). dibbla init either created that file or merged a marker-delimited block into your existing one — your own content is preserved.
Restart your Opencode session and try:
Use the dibbla skill to deploy this directory as a new app.Most modern coding agents — Codex, Copilot, Windsurf, Aider, Zed, Warp, RooCode — read AGENTS.md at the project root (open standard). dibbla init wrote (or merged into) that file with the skill’s full context, so any AGENTS.md-aware tool picks it up automatically.
If your agent doesn’t read AGENTS.md yet, paste the output of dibbla --skill-prompt into its system prompt or context window — it contains the same instructions written for direct LLM consumption.
See the skills guide for per-project vs $HOME install, the bundled skill list, and troubleshooting.