Setup: Use with AI agents. The server runs locally, uses your saved token and talks to https://deploy.tja.nrw.
| Tool |
What it does |
deploy_app |
Build and deploy a folder; waits until it’s live or failed and returns the error, a hint and logs. |
whoami |
The account the agent deploys as, usage and limits. |
list_apps |
Apps with URL, readiness and last deploy. |
app_status |
Health, crash reason, CPU and memory, warnings. |
app_logs |
Recent output of the app. |
set_env |
Set or remove variables; restarts the app. Returns names only. |
deploy_history |
Past deploys, or the full log of one. |
create_database |
New PostgreSQL or Redis database. |
list_databases |
Databases with status and linked apps. |
link_database |
Put a database’s connection string into an app. |
delete_database |
Delete a database and its data. |
delete_app |
Delete an app. |
registry_cleanup |
Remove old images (platform admins). |
| Parameter |
|
path |
Absolute path of the project folder. Required. |
name |
App name. Default: vibe.json, then the folder name. |
port |
Port, if the app ignores $PORT. |
env |
Variables to set before deploying, as an object. |
volume |
true for a 2 GB volume at /data. |
databases |
Names of databases to link. |
| Parameter |
|
name |
Database name, for example shop-db. |
type |
postgres or redis (create only). |
database, app |
Which database goes into which app (link only). |
env_name |
Another variable name than DATABASE_URL / REDIS_URL (link only). |
A first build can take a few minutes. If your client gives up early, raise its tool timeout (Codex: tool_timeout_sec = 600). The deploy keeps going on the server either way; check it with deploy_history.
