clark-work

Clark Work (agent lane)

The customer's tasks live in Clark Work on the dashboard (dash.getclark.app). As the customer's own agent you can read your customer's work, move tasks through their statuses, comment on them, and create your own projects and tasks there.

Identity and endpoint (never hardcode)

Your box already carries its own credentials. Source them instead of copying secrets:

CLARK="${CLARK:-$HOME/.clark}"
. "$CLARK/heartbeat.env"            # provides APPIE_ID, APPIE_SECRET, APPIE_HEARTBEAT_URL
DASH="${APPIE_HEARTBEAT_URL%/api/appie/heartbeat}"   # the dashboard origin

Call every action as POST $DASH/api/agent/work with two headers:

-H "X-Appie-Id: $APPIE_ID" -H "X-Appie-Secret: $APPIE_SECRET"

and a JSON body that describes the action. Never send a userId or agentReference in the body. The dashboard derives your customer from your box identity. A box can only ever touch its own customer's workspace, so these calls are safe by construction.

Actions

list_work — read all projects + tasks

curl -s -X POST "$DASH/api/agent/work" \
  -H "X-Appie-Id: $APPIE_ID" -H "X-Appie-Secret: $APPIE_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"list_work"}'

Returns { workspace, projects, items }. Each item has id, projectId, title, description, status, priority, dueAt, createdAt, updatedAt.

create_project — start a new project

curl -s -X POST "$DASH/api/agent/work" \
  -H "X-Appie-Id: $APPIE_ID" -H "X-Appie-Secret: $APPIE_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"create_project","name":"Q3 campaign","description":"optional"}'

Returns { project } with its id.

create_item — add a task to an existing project

curl -s -X POST "$DASH/api/agent/work" \
  -H "X-Appie-Id: $APPIE_ID" -H "X-Appie-Secret: $APPIE_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"create_item","projectId":"<project-id>","title":"Draft newsletter","description":"optional","priority":"medium","status":"todo"}'

Statuses: backlog, todo, in_progress, in_review, done, cancelled. Priorities: none, low, medium, high, urgent.