base44-cli Skill for Claude: What It Does and How to Install It
Makes Claude create, run and deploy Base44 apps with the base44 command line.
- Installs
- 11.8K
- on skills.sh
- Stars
- 92
- on GitHub
- Files
- 51
- besides SKILL.md
- Updated
- Nov 2026
- last repo commit
This is Base44's own skill for the Base44 command line. It tells Claude to run npx base44 commands for project setup, local development, deployment, entities, backend functions, realtime actors, AI agents, connectors, auth settings, secrets and one-off scripts, with a reference file for most commands.
It starts when you mention "base44" or when a base44/ folder exists. Claude first runs npx base44 whoami. If you are not signed in it stops and asks you to log in. Many of these commands change your live app, so the safety box below matters.
Good for
- Developers who build and deploy Base44 full-stack apps from the terminal
- People who want Claude to run base44 commands such as create, dev and deploy
- Teams managing Base44 entities, backend functions, agents and connectors as files
Install base44-cli
Claude Code
- 1
Copy this prompt.
Install the base44-cli skill in Claude Code. Run this command: /plugin marketplace add base44/skills /plugin install base44@base44-skills Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Pick one route, not several. The plugin route installs 12 skills in one go: base44-cli, base44-sdk, base44-troubleshooter and 9 base44-platform skills (counted from plugin.json). The skills CLI route names base44-cli next to this skill because the skills hand work to each other. The Antigravity route in the README packages base44-sdk, base44-troubleshooter and base44-cli.
From the project README. Source.
What's in the skill
When it loads
The base44 CLI is used for EVERYTHING related to base44 projects: resource configuration (entities, backend functions, realtime actors, ai agents), initialization and actions (resource creation, deployment), and any other operation on an existing app or workspace through the Base44 public API (settings, domains, users, members, source export). This skill is the place for learning about how to configure resources, including actors — the realtime/WebSocket primitive behind multiplayer, collaborative boards, presence and live cursors, in-room chat, and live auctions. When you plan or implement a feature, you must learn this skill
Sections in SKILL.md
- ⚡ IMMEDIATE ACTION REQUIRED - Read This First
- Critical: Local Installation Only
- MANDATORY: Authentication Check at Session Start
- Overview
- When to Use This Skill vs base44-sdk
- Project Structure
- Installation
- Global --app-id Option
- Global --json Option
- Available Commands
- Authentication
- Project Management
- Workspace Management
- Development
- Deployment
- Entity Management
Key facts
- Repo
- base44/skills
- Installs on skills.sh
- 11,787 (Nov 2, 2026)
- GitHub stars
- 92 for the whole repo (Nov 2, 2026)
- Last repo commit
- Nov 1, 2026
- Audits on skills.sh
- Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
- Status
- Beta, per the README
What it includes
Runs npx base44 whoami first and stops if you are not logged in
SKILL.md calls this check mandatory. If it fails, Claude asks you to run npx base44 login yourself and waits.
Runs code ·
Session checkStarts a project: create for new apps, scaffold for provisioned ones, link for local files
scaffold sets up local files for an app that already exists, and SKILL.md says not to run create there because it would make a duplicate.
Try: “Create a new Base44 app called my-app in this folder”
Runs code ·
create / scaffold / linkSigns in with a device code flow, signs out, shows the current user
Runs code ·
login / logout / whoamiRuns a local backend; dev --remote serves the frontend against production
Runs code ·
devBuilds with the app id injected, then deploys all resources and the site
SKILL.md says to build with `npx base44 build`, not a bare npm run build, or the deployed bundle cannot find its app.
Try: “Deploy my Base44 app”
Runs code ·
build and deployPushes entity schemas from base44/entities to Base44
Runs code ·
entities pushManages backend functions; --force prunes remote ones missing locally
Delete ·
functions deploy / delete / list / pullDeploys or tears down realtime actors
Delete ·
actors deploy / deleteSyncs AI agent configs and agent skill files, replacing the other side
Delete ·
agents and agent-skills push / pullSets up OAuth connectors such as Google Calendar or Slack
OAuth consent happens in your browser.
Runs code ·
connectors list-available / initiate / pull / pushChanges how your app's users sign in
Runs code ·
auth password-login / social-login / sso / pull / pushManages secrets stored in Base44
Delete ·
secrets list / set / deleteRuns a script from stdin with the Base44 SDK signed in as you
Runs code ·
execReads function logs and workflow runs
Runs code ·
logs and workflowsGenerates base44/.types/types.d.ts and updates tsconfig.json
SKILL.md says this runs locally and needs no authentication.
Runs code ·
types generateUploads a built single-page site to Base44 hosting
Runs code ·
site deploy / openLists workspaces, moves an app between them, sets public, private or workspace visibility
Runs code ·
workspace and visibilityFinds and calls any other public Base44 API operation, such as custom domains
Use search first, read the operation's contract with --help, then call it.
Runs code ·
api search / catalog / grep / fetch
From the official docs
Permissions
High risk
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Deploy and push commands change your live app
`deploy` ships entities, functions, actors, agents, agent skills, connectors, auth config and the site. The quick start uses `npx base44 deploy --build -y`, which skips the prompts. Run deploy yourself, or drop -y. github.com
Some pushes delete remote items
SKILL.md says agents push and agent-skills push replace all remote copies with local ones, and `functions deploy --force`, `connectors push --force` and `actors delete` remove things. Its troubleshooting table calls entities push, agents push, agent-skills push and connectors push --force destructive. Read each prompt before you confirm. github.com
dev --remote writes to production data
Plain `npx base44 dev` uses a throwaway local backend. With `--remote` the frontend talks to the real app, and SKILL.md says every write hits the live app. Check which one Claude started. github.com
It can set and delete app secrets
`base44 secrets set` and `secrets delete` change secrets stored in Base44. Never paste real keys into the chat; use KEY=VALUE or an env file you control. github.com
api fetch and exec act as you
`base44 api fetch` calls any public Base44 API operation with your CLI login. `base44 exec` runs a script against your deployed app by default, and its reference says `--privileged` bypasses row-level security and needs the app owner or editor role. Add `--read-only` to api fetch while you are only looking. github.com
It installs the base44 package
The Installation section runs `npm install --save-dev base44` with no version. Later commands run through npx, yarn or pnpm. github.com
Technical details
| Turning on read-only | Only `base44 api fetch` has a --read-only flag. There is no read-only mode for the skill as a whole. |
|---|---|
| Sign-in and keys | SKILL.md says your session is stored locally and persists across CLI sessions. The CLI also accepts a BASE44_API_KEY (prefix b44k_) or BASE44_ACCESS_TOKEN and BASE44_REFRESH_TOKEN from the environment. |
| Scopes |
|
Questions
What does the base44-cli skill do?
It makes Claude use the Base44 command line (npx base44 ...) to create, link, run locally and deploy Base44 apps. It also covers entities, backend functions, actors, agents, connectors, auth settings, secrets and type generation.
How do I install base44-cli?
Use the install box above. The plugin route installs it with base44-sdk and 10 other skills. With the skills CLI, name base44-sdk too, since each skill hands work to the other.
Do I need a Base44 account?
Yes for most commands. At the start of a session Claude runs npx base44 whoami. If you are not logged in it stops and asks you to run npx base44 login. The CLI also accepts a workspace API key in BASE44_API_KEY, which skips the interactive login.
Is it safe to let Claude run it?
It can deploy to your live app, push over remote agents and entities, and set or delete secrets. The skill bundles no scripts but runs CLI commands that change your real app. Our advice: run deploy and push commands yourself, read each prompt, and avoid -y unless you mean it.
What is the difference between dev and dev --remote?
npx base44 dev starts a local backend whose data is empty each start. npx base44 dev --remote serves only the frontend against the production backend, so every write changes the live app. SKILL.md says to default to plain dev.
base44-cli vs base44-sdk?
base44-cli creates, configures and deploys a project. base44-sdk writes the JavaScript or TypeScript that calls Base44 inside an existing project. SKILL.md hands existing projects to base44-sdk.
Does it work in the Claude app?
The README documents Claude Code, Codex CLI, Antigravity and other agents through the skills CLI. It documents no Claude app upload route, and this skill needs a terminal for npx base44.
Is it an official Base44 skill?
It is in Base44's own repo, and the repo's marketplace.json describes the skills as "Official Base44 skills for Claude Code". The README marks them as beta.
Information
updated Nov 2, 2026
- Repository
- base44/skills
- Folder
skills/base44-cli
Sources
Docs, issue trackers and discussions this page is built from.
Show all 6Hide
- base44/skills README · github.com
- base44/skills marketplace.json · github.com
- base44 plugin.json · github.com
- base44-cli SKILL.md · github.com
- base44 api fetch reference · github.com
- base44 exec reference · github.com