@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

🔗 関連リンク

• acomo 公式サイト
• @acomo/client NPM パッケージ
• @acomo/cli NPM パッケージ