@acomo/cli
acomo ワークフロー管理プラットフォームの公式 CLI ツールです。
📦 インストール
npm install -g @acomo/cli
🚀 クイックスタート
1. ログイン
アクセストークンはブラウザで acomo にログインした後に入手し、CLI で指定して保存します。
# オプションで指定
acomo login --tenant-id <your-tenant-id> --access-token <your-access-token>
# または対話形式（baseUrl / tenantId / accessToken をプロンプトで入力。既存設定はデフォルト表示され Enter でそのまま採用）
acomo login
2. API を呼び出す
# 現在のユーザー情報を取得
acomo getCurrentUser
# ワークフローモデル一覧を取得
acomo listWorkflowModels
# JSON パラメータを指定して呼び出す
acomo listWorkflowModels '{"filter":"published","take":10}'
📖 使い方
ログイン
アクセストークンでログイン
アクセストークンはブラウザで acomo にログインした後に取得できます。取得したトークンを CLI で指定して保存します。
acomo login --tenant-id <tenant-id> --access-token <access-token>
baseUrl を指定する
acomo login --base-url https://custom.acomo.app --tenant-id <tenant-id> --access-token <access-token>
API 呼び出し
全ての acomo API がコマンドとして利用可能です。
基本的な使い方
acomo <operationId> [JSON引数]
引数なしの API
acomo getCurrentUser
acomo getCurrentTenant
acomo getAccount
JSON 引数を渡す
# コマンドライン引数として渡す
acomo getWorkflowModel '{"modelId":"wf_xxx"}'
# stdin から渡す
echo '{"modelId":"wf_xxx"}' | acomo getWorkflowModel
# ファイルから渡す
acomo createWorkflowModel < model-data.json
出力形式
# テキスト形式（デフォルト）
acomo listWorkflowModels
# JSON 形式
acomo listWorkflowModels --format json
設定管理
# 現在の設定を表示（トークンはマスク表示）
acomo config show
# 設定を更新
acomo config set baseUrl https://custom.acomo.app
# ログアウト（設定をクリア）
acomo logout
🎯 主要なコマンド例
ワークフローモデル
# モデル一覧を取得
acomo listWorkflowModels
# フィルタ付きで取得
acomo listWorkflowModels '{"filter":"published","take":10}'
# 特定のモデルを取得
acomo getWorkflowModel '{"modelId":"wf_xxx"}'
# モデルを作成
acomo createWorkflowModel '{"body":{"name":"新しいワークフロー","description":"説明"}}'
# モデルを削除
acomo deleteWorkflowModel '{"modelId":"wf_xxx"}'
ワークフロープロセス
# プロセス一覧を取得
acomo listWorkflowProcesses
# フィルタ付きで取得
acomo listWorkflowProcesses '{"filter":"running","take":20}'
# 特定のプロセスを取得
acomo getWorkflowProcess '{"processId":"proc_xxx"}'
# プロセス履歴を取得
acomo listWorkflowProcessHistories '{"processId":"proc_xxx"}'
プロフィール・アカウント
# 現在のユーザー情報
acomo getCurrentUser
# 現在のテナント情報
acomo getCurrentTenant
# アカウント情報
acomo getAccount
# 組織情報
acomo getMyOrganization
⚙️ 設定
環境変数
以下の環境変数で API 呼び出しに必要な情報を設定できます。
| 環境変数 | 説明 | 必須 | デフォルト |
|---|---|---|---|
ACOMO_ACCESS_TOKEN | アクセストークン | Yes | - |
ACOMO_TENANT_ID | テナント ID | Yes | - |
ACOMO_BASE_URL | API の Base URL | No | https://acomo.app |
環境変数を設定しておけば、acomo login なしで直接 API を呼び出せます。
export ACOMO_TENANT_ID="your-tenant-id"
export ACOMO_ACCESS_TOKEN="your-access-token"
acomo getCurrentUser
優先順位
CLI オプション > 環境変数 > 設定ファイル（~/.acomo/config.json）
CLI オプションや環境変数が指定されている場合、設定ファイルの値より優先されます。
設定ファイル
acomo login を実行すると ~/.acomo/config.json に認証情報が保存されます。
{
"baseUrl": "https://acomo.app",
"tenantId": "your-tenant-id",
"accessToken": "your-access-token"
}
ファイルのパーミッションは 0600 に設定され、本人のみがアクセス可能です。
🔧 開発者向け
ビルド
npm run build
開発モード
npm run dev
クリーンビルド
npm run clean && npm run build
📝 ライセンス
ISC