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 に
acomomust exist). - When an agent runs the CLI, in a remote sandbox etc., the local
~/.acomo/config.jsonor 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 loginexecution, or setting the environment variableACOMO_ACCESS_TOKEN,ACOMO_TENANT_IDsettings
Authentication
- Local Use:
acomo loginで~/.acomo/config.jsonPersistently 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 valuenamed 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
- Model List:
acomo listWorkflowModelsIdentify the target model with. Filter example:acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}' - Model Definition:
acomo getWorkflowModel --modelId <ID>Retrieve the JSON of definition / dataSchema / policy with. - Process Operations: Use as needed
startWorkflowProcess/saveWorkflowProcess/submitWorkflowProcess/submitWorkflowProcessWithNodeId/approveWorkflowProcess/rejectWorkflowProcess/revertWorkflowProcess. For your own process list, considerlistMyProcessesや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.