commitlydocs
← back to home
act

commitly-agent act

Execute a single queued narrative task.

commitly-agent act <projectPath> [--behavior <mode>] [--yes]

## description

Pulls one queued phantom task from the dashboard and runs it locally — generates a small AI-driven edit consistent with the multi-day arc, shows you the diff, and (with confirmation) commits it. Stops after one task. For continuous execution use act-loop.

## flags

flagdescription
--behavior <docs|refactor|ghost>
Skips the interactive behavior prompt. Required in non-TTY environments.
-y, --yes
Auto-confirm the commit without prompting. Required in non-TTY environments.

## example

$ commitly-agent act ~/code/api --behavior docs --yes

→ Waking up agent in ~/code/api…
→ Polling dashboard queue for tasks…
→ Task fetched: [task_8f3a]
→ Synthesizing edit on src/lib/db.ts…
→ Wrote src/lib/db.ts
── Proposed diff ──────────────────────────────
+ /** Returns a pooled connection... */
✓ Committed locally: "docs(db): document pool helper"
✓ Task complete and marked in dashboard.

## notes

See the full command reference, or jump to Daemon mode if you plan to run this unattended.