AI Agent Setup
Your coding agent deploys with the Telbase skills: instructions it reads from your app's folder, with the commands and the known fixes for each kind of app.
Recommended
telbase skill installWrites the Telbase skills where your agent reads them. Run it in your app's folder, after npm install -g telbase and telbase login.
Or a single file
SKILL.md folders: telbase-deploy (registering an app, databases, file storage, scheduled jobs, env vars, plans and refusals), vercel and cloud-run (deploying to each provider through Telbase). The CLI carries them, so telbase skill install always writes the version that matches your CLI.Setup
Install the CLI and sign in
The CLI needs Node.js.
npm install -g telbase
telbase loginInstall the skills in your app’s folder
Pick your agent with --for (below). Claude Code is the default.
telbase skill installAsk your agent to deploy
The agent registers the app, deploys it, and checks it at its Telbase URL.
Deploy this app to TelbaseEach agent
telbase skill install writes the skills in this directory; --global writes them in your home directory, for every project.
telbase skill installWrites .claude/skills/ (--global: ~/.claude/skills/). The MCP server is optional.
TELBASE.md
For an agent that reads neither skills nor AGENTS.md, add TELBASE.md to your repo root and point the agent at it. It summarises the same workflow in one file:
<!-- AI Agent: This file contains deployment instructions for Telbase (telbase.ai).
Use these commands when the user asks to deploy their application. -->
<!-- telbase-docs v3 — a single-file summary of the Telbase skills (`telbase skill install` writes the full skills) -->
# Telbase Deployment Guide
Telbase hosts the user's app on Telbase-owned provider accounts: Vercel for web frontends and request/response Node apps, Google Cloud Run for containers and every other runtime, Neon for PostgreSQL, Turso for SQLite, and private S3-compatible buckets for the files an app keeps. You deploy with the real vendor CLIs through Telbase's launchers (`telbase vercel`, `telbase gcloud`), which carry the user's Telbase session. Neither you nor the user needs a Vercel, Google, Neon or Turso account. Each app is served at `https://<name>.telbase.ai`, its Telbase URL.
## Setup
```bash
npm install -g telbase # needs Node.js; Cloud Run apps also need gcloud installed
telbase login # opens the browser
telbase skill install # the full skills, where your agent reads them (--for cursor|windsurf|agents-md)
```
If the skills are installed, follow them: they are more complete than this file.
...Next Steps
- Quick Start — deploy your first app
- Claude Code — the skills and the MCP server
- Supported Frameworks — where each kind of app runs
- Databases — PostgreSQL, SQLite, migrations, pgvector
- Troubleshooting — common errors and fixes