SuperAPI AI Directory

acomo

General & other

View repository

Updated 10-15 23:27

About this skill

acomo CLI / API Standard Guide

acomo is a workflow management platform. This skill standard usage of the acomo CLI and public API(model list, model definition retrieval, process start, save, submit, approve, reject, send back, etc.).

Prerequisites / Execution Environment

  • An environment where the acomo CLI can run(PATH に acomo must exist).
  • When an agent runs the CLI, in a remote sandbox etc., the local ~/.acomo/config.json or environment variables may not be automatically inherited. When running in CI or an agent, environment variables (ACOMO_ACCESS_TOKEN, ACOMO_TENANT_ID, ACOMO_BASE_URL) is recommended.
  • Even when authentication is not configured, the API commands exist, and at execution time they fail with exit code 2 and stderr AUTH_REQUIRED . In that case, prompt the user to log in again (or set environment variables).

Handling Authentication Errors

If an authentication error occurs (authentication not configured, 401/403, exit code 2), do not try to resolve it by trial and error. Prompt the user to log in promptly, and abort the process.

  • acomo login execution, or setting the environment variable ACOMO_ACCESS_TOKEN, ACOMO_TENANT_ID settings

Authentication

  • Local Use: acomo login で ~/.acomo/config.json Persistently saved to.
  • CI / Agent Environment: Authentication via environment variables is recommended.

Obtain the access token after logging in to acomo in a browser, and specify it with the CLI.

# 環境変数で認証(非インタラクティブ向け)
export ACOMO_ACCESS_TOKEN="your-token"
export ACOMO_TENANT_ID="your-tenant-id"

# または login で保存
acomo login --tenant-id <tenantId> --access-token <accessToken>
Environment Variable Description Required
ACOMO_ACCESS_TOKEN Access Token Yes
ACOMO_TENANT_ID Tenant ID Yes
ACOMO_BASE_URL API Base URL (when omitted: https://acomo.app) No

The CLI output is JSON. Check parameters with acomo <operationId> --help .

Call Format

acomo <operationId> [--option value...] [body-json]
  • path/query parameters → --name value named option in the format
  • Request Body → JSON string as a positional argument (or stdin)
# path param のみ(GET など)
acomo getWorkflowModel --modelId <ID>

# query params
acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}'

# body のみ(POST)
acomo createWorkflowModel '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'

# path param + body(PUT)
acomo saveWorkflowModel --modelId <ID> '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'

# stdin から body を渡す
echo '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}' | acomo createWorkflowModel

Standard Flow

  1. Model List: acomo listWorkflowModels Identify the target model with. Filter example: acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}'
  2. Model Definition: acomo getWorkflowModel --modelId <ID> Retrieve the JSON of definition / dataSchema / policy with.
  3. Process Operations: Use as needed startWorkflowProcess / saveWorkflowProcess / submitWorkflowProcess / submitWorkflowProcessWithNodeId / approveWorkflowProcess / rejectWorkflowProcess / revertWorkflowProcess . For your own process list, consider listMyProcesses や listProcessWithNodeActions .

Main Command Quick Reference

Purpose Command
Model List listWorkflowModels
Model Definition Retrieval getWorkflowModel --modelId <ID>
Model Being Edited getWorkflowModelWithLatestModelHistory --modelId <ID>
Process Start startWorkflowProcess --modelId <ID>
Data Save saveWorkflowProcess --processId <ID> '{"data":{...}}'
Submit submitWorkflowProcess --processId <ID>
Approve approveWorkflowProcess --processId <ID>
Reject rejectWorkflowProcess --processId <ID>
Send back revertWorkflowProcess --processId <ID> --nodeId <nodeId>
List own processes listMyProcesses / listProcessWithNodeActions
Get own process getMyProcesses / getProcessWithNodeActions

In process operations, for a task node, send data according to dataSchema in the saveWorkflowProcess の body の data field. Transitions are executed with submit / approve / reject / revert. Follow the write/read of the policy, and handle only the items that are editable at the current node.

Notes

  • For details on the data structures (definition / dataSchema / policy / conditional expressions), refer to reference.md .
  • Check the full command list with acomo --help .