​

Base44 CLI

​

⚡ 即時アクション必須 - まずこれを読む

1. カレントディレクトリに base44/config.jsonc が存在するか確認する
2. 存在する 場合 (既存プロジェクトのシナリオ):
   • base44-sdk スキルへ引き継いで実装する
   • このスキルは CLI コマンド (login、deploy、entities push) のみを扱います
3. 存在しない 場合、次の 2 つの初期化パスから決定する:
   • プロビジョニング済みアプリ — Stripe Projects / projects.dev フローを通じてプロビジョニングされたため Base44 アプリがすでに存在する、または BASE44_APP_ID (もしくは BASE44_PROJECTS_BASE44_APP_ID) が環境または .env/.env.local ファイルに存在する場合:
     • npx base44 scaffold を実行して、既存の アプリのローカルファイルをセットアップします
     • npx base44 create は実行しないでください — 重複した 2 つ目のアプリが作成されます。scaffold.md を参照してください。
   • 新規プロジェクト — アプリがまだ存在せず、プロビジョニングもされていない場合:
     • このスキル (base44-cli) がリクエストを処理し、ユーザーに npx base44 create を案内します
     • base44-sdk はまだ有効化しないでください

​

重要: ローカルインストールのみ

• npx base44 <command> (npm - 推奨)
• yarn base44 <command> (yarn)
• pnpm base44 <command> (pnpm)

​

必須: セッション開始時の認証チェック

1. 認証状態を確認 するには次を実行します:
   npx base44 whoami
   
2. ユーザーがログイン済み の場合 (コマンドが成功し、メールアドレスが表示される):
   • リクエストされたタスクを続行します
3. ユーザーがログインしていない 場合 (コマンドが失敗またはエラーを表示する):
   • 直ちに停止します
   • CLI 操作を 一切実行しません
   • ユーザーに手動でログインするよう依頼します 次のコマンドを実行してもらいます:
     npx base44 login
     
   - ユーザーがログイン完了を確認するまで続行を待ちます
   

​

概要

​

このスキルと base44-sdk の使い分け

• 新規 の Base44 プロジェクトをゼロから作成する
• 空のディレクトリでプロジェクトを初期化する
• 外部でプロビジョニングされた 既存 アプリ (例: Stripe Projects / projects.dev フロー経由) のローカルファイルをセットアップする → scaffold を使用
• ディレクトリに base44/config.jsonc が存在しない
• ユーザーの発言: 「新しいプロジェクトを作成」「プロジェクトを初期化」「プロジェクトをセットアップ」「新しい Base44 アプリを開始」
• CLI 経由でデプロイ、エンティティのプッシュ、認証を行う
• CLI コマンド (npx base44 ...) を扱う

• 既存の Base44 プロジェクトで機能を構築する
• base44/config.jsonc がすでに存在する
• Base44 SDK を使って JavaScript/TypeScript コードを書く
• 機能、コンポーネント、フィーチャーを実装する
• ユーザーの発言: 「実装する」「機能を構築する」「機能を追加する」「コードを書く」

• base44-cli は新規プロジェクトにおける base44-sdk の 前提条件 です
• ユーザーが「アプリを作成」したく、Base44 プロジェクトが存在しない場合は、まず base44-cli を使用します
• base44-sdk は Base44 プロジェクトがすでに初期化されていることを前提とします

• IF (ユーザーが「アプリを作成/構築」または「プロジェクトを作る」と発言):
  • IF (base44/config.jsonc が存在): → base44-sdk を使用 (プロジェクトが存在するため機能を構築)
  • ELSE IF (アプリが外部でプロビジョニング済み — BASE44_APP_ID/BASE44_PROJECTS_BASE44_APP_ID が設定されている、または Stripe Projects / projects.dev フローが実行された直後): → base44-cli → npx base44 scaffold を使用 (既存アプリのローカルファイルをセットアップ; create は行わない)
  • ELSE: → base44-cli → npx base44 create を使用 (新規プロジェクト初期化が必要)

​

プロジェクト構造

my-app/
├── base44/                      # Base44 configuration (created by CLI)
│   ├── config.jsonc             # Project settings, site config
│   ├── .types/                  # Auto-generated TypeScript types (created by `types generate`)
│   │   └── types.d.ts           # Module augmentation for @base44/sdk
│   ├── entities/                # Entity schema definitions
│   │   ├── task.jsonc
│   │   └── board.jsonc
│   ├── functions/               # Backend functions (optional)
│   │   └── my-function/
│   │       └── entry.ts
│   ├── agents/                  # Agent configurations (optional)
│   │   └── support_agent.jsonc
│   └── connectors/              # OAuth connector configurations (optional)
│       └── googlecalendar.jsonc
├── src/                         # Frontend source code
│   ├── api/
│   │   └── base44Client.js      # Base44 SDK client
│   ├── pages/
│   ├── components/
│   └── main.jsx
├── index.html                   # SPA entry point
├── package.json
└── vite.config.js               # Or your framework's config

• base44/config.jsonc - プロジェクト名、説明、サイトのビルド設定
• base44/entities/*.jsonc - データモデルスキーマ (Entity Schema セクションを参照)
• base44/functions/*/entry.ts - バックエンド関数のエントリーポイント
• base44/agents/*.jsonc - エージェント構成 (オプション)
• base44/.types/types.d.ts - エンティティ、関数、エージェント用の自動生成 TypeScript 型 (npx base44 types generate で生成)
• base44/connectors/*.jsonc - OAuth コネクタ構成 (オプション)
• src/api/base44Client.js - フロントエンドで使用する事前構成済み SDK クライアント

{
  "name": "My App",                    // Required: project name
  "description": "App description",    // Optional: project description
  "entitiesDir": "./entities",         // Optional: default "entities"
  "functionsDir": "./functions",       // Optional: default "functions"
  "agentsDir": "./agents",             // Optional: default "agents"
  "connectorsDir": "./connectors",     // Optional: default "connectors"
  "site": {                            // Optional: site deployment config
    "installCommand": "npm install",   // Optional: install dependencies
    "buildCommand": "npm run build",   // Optional: build command
    "serveCommand": "npm run dev",     // Optional: local dev server
    "outputDirectory": "./dist"        // Optional: build output directory
  }
}

​

インストール

npm install --save-dev base44

npx base44 <command>

​

グローバル --app-id オプション

# Run a one-off script against a specific app
cat ./script.ts | npx base44 exec --app-id app_123

# Fetch logs for a deployed app without a local checkout
npx base44 logs --app-id app_123 --level error

• base44 create は新しいアプリを作成するため --app-id を拒否します
• base44 dev はリンクされたローカルプロジェクトから実行するため --app-id を拒否します
• base44 deploy はローカルリソースを読み取るため、依然としてローカルプロジェクトディレクトリが必要です

​

利用可能なコマンド

​

認証

​

プロジェクト管理

​

開発

​

デプロイ

​

エンティティ管理

​

エンティティスキーマ (クイックリファレンス)

{
  "name": "EntityName",
  "type": "object",
  "properties": {
    "field_name": {
      "type": "string",
      "description": "Field description"
    }
  },
  "required": ["field_name"]
}

​

関数管理

​

エージェント管理

​

エージェントスキーマ (クイックリファレンス)

{
  "name": "agent_name",
  "description": "Brief description of what this agent does",
  "instructions": "Detailed instructions for the agent's behavior",
  "tool_configs": [
    // Entity tool - gives agent access to entity operations
    { "entity_name": "tasks", "allowed_operations": ["read", "create", "update", "delete"] },
    // Backend function tool - gives agent access to a function
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"
}

• エージェント名はパターン /^[a-z0-9_]+$/ に一致する必要があります (小文字英数字とアンダースコア、1-100 文字)
• 有効: support_agent, order_bot
• 無効: Support-Agent, OrderBot

• Entity tools: entity_name + allowed_operations (配列: read, create, update, delete)
• Backend function tools: function_name + description

​

コネクタ管理

​

コネクタスキーマ (クイックリファレンス)

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

​

認証設定

​

シークレット管理

​

スクリプト実行

​

型生成

​

サイト管理

​

クイックスタート

1. プロジェクトに CLI をインストール:
   npm install --save-dev base44
   
2. Base44 に認証:
   npx base44 login
   
3. 新規プロジェクトを作成 (常に name と --path フラグを指定):
   npx base44 create my-app --path .
   
4. ローカル開発を実行:
   npx base44 dev
   
5. ビルドしてすべてをデプロイ:
   npm run build
   npx base44 deploy -y
   

• npx base44 entities push - エンティティのみプッシュ
• npx base44 functions deploy - 関数のみデプロイ
• npx base44 functions delete <name> - デプロイ済み関数を削除
• npx base44 functions list - すべてのデプロイ済み関数を一覧表示
• npx base44 functions pull - デプロイ済み関数をローカルファイルにプル
• npx base44 agents push - エージェントのみプッシュ
• npx base44 connectors pull - Base44 からコネクタをプル
• npx base44 connectors push - コネクタのみプッシュ
• npx base44 auth pull - Base44 から認証設定をプル
• npx base44 auth push - 認証設定のみプッシュ
• npx base44 site deploy -y - サイトのみデプロイ

​

一般的なワークフロー

​

新規プロジェクトの作成

• テンプレート選択 - 正しいテンプレート (backend-and-client と backend-only) を選択
• 正しいワークフロー - テンプレートごとに必要なセットアップ手順が異なります
• よくある落とし穴 - 失敗の原因となるフォルダー作成エラーを回避

​

既存プロジェクトのリンク

# If you have base44/config.jsonc but no .app.jsonc
npx base44 link --create --name my-app

​

ローカル開発の実行

# Starts the Base44 backend locally
npx base44 dev

​

すべての変更のデプロイ

# Generate types (optional, for TypeScript projects)
npx base44 types generate

# Build your project first
npm run build

# Deploy everything (entities, functions, and site)
npx base44 deploy -y

​

TypeScript 型の生成

# Generate types from entities, functions, agents, and connectors
npx base44 types generate

​

個別リソースのデプロイ

# Push only entities
npx base44 entities push

# Deploy only functions (all)
npx base44 functions deploy
# Deploy specific functions
npx base44 functions deploy my-function other-function
# Deploy and prune removed functions
npx base44 functions deploy --force

# Push only agents
npx base44 agents push

# Pull connectors from Base44
npx base44 connectors pull

# Push only connectors
npx base44 connectors push

# Deploy only site
npx base44 site deploy -y

​

ダッシュボードを開く

# Open app dashboard in browser
npx base44 dashboard

​

認証

​

トラブルシューティング