commitlydocs
← back to home
daemon

commitly-agent start

Register and start the background daemon.

commitly-agent start <projectPath> [--repo <owner/repo>] [--behavior <mode>]

## description

Generates a launchd plist (macOS) or systemd user unit (Linux), registers it, and starts it. The daemon runs `act-loop` with `--yes` and your chosen behavior baked in. Credentials are read from your keychain; Linux passes them through systemd credentials, while macOS uses a user-only plist.

## flags

flagdescription
--repo <owner/repo>
Skip the interactive repo picker.
--behavior <docs|refactor|ghost>
AI behavior the daemon will use for every task. (default: docs)

## example

$ commitly-agent start ~/code/api --repo myorg/api --behavior docs

✓ Daemon registered and started via systemd.
   Logs: commitly-agent logs

## notes

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