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

bash
telbase skill install

Writes 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

Download
What are the Telbase skills?
Three 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

1

Install the CLI and sign in

The CLI needs Node.js.

bash
npm install -g telbase
telbase login
2

Install the skills in your app’s folder

Pick your agent with --for (below). Claude Code is the default.

bash
telbase skill install
3

Ask your agent to deploy

The agent registers the app, deploys it, and checks it at its Telbase URL.

bash
Deploy this app to Telbase

Each agent

telbase skill install writes the skills in this directory; --global writes them in your home directory, for every project.

bash
telbase skill install

Writes .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:

markdown
<!-- 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