CLI commands

Complete reference for all dojops-sa commands.

setup

Interactive first-run wizard. Configures the database, license, LLM provider check, and optional connector.

dojops-sa setup

See setup guide for the full walkthrough.

start

Start the autonomous agent loop. Polls connected ticketing systems for assigned tickets, processes them, and reports results.

dojops-sa start [options]

Examples:

# Default: poll every 5 minutes
dojops-sa start
 
# Single pass (useful for CI or testing)
dojops-sa start --once
 
# Poll every 2 minutes, process up to 3 tickets per cycle
dojops-sa start --interval 120000 --limit 3

svc

Manage dojops-sa as a systemd service so it keeps polling in the background without a terminal session. Linux only.

Two modes are supported.

The default is user mode: the unit is written to ~/.config/systemd/user/dojops-sa.service and every subcommand runs via systemctl --user. No sudo is needed, the agent runs as your user, and it reads state from ~/.dojops-super-agent/ out of the box. User services stop when you log out, unless you enable linger with sudo loginctl enable-linger $USER.

Passing --system switches to system mode: the unit is written to /etc/systemd/system/dojops-sa.service with User= and Environment=HOME= pinned to your user, so state still lives in your home directory. The service starts on boot, and install/remove need sudo.

Typical first run:

dojops-sa svc install
dojops-sa svc enable
dojops-sa svc start

The install step resolves the dojops-sa binary with which dojops-sa, so install it globally first (npm i -g @dojops/super-agent) before registering the service. Re-running install rewrites the unit and reloads the daemon, which is safe after an upgrade.

svc install

Write the unit file and reload the systemd daemon.

dojops-sa svc install [--system]

svc enable

Enable auto-start. User mode starts on next login; system mode starts on next boot.

dojops-sa svc enable [--system]

svc disable

Disable auto-start. Leaves the unit file in place so you can re-enable it later.

dojops-sa svc disable [--system]

svc start

Start the service immediately.

dojops-sa svc start [--system]

svc stop

Stop the running service.

dojops-sa svc stop [--system]

svc status

Show current systemd status for the service, including recent journal lines.

dojops-sa svc status [--system]

Logs go to the journal with identifier dojops-sa. Tail them with:

journalctl --user -u dojops-sa -f          # user mode
sudo journalctl -u dojops-sa -f            # system mode

svc remove

Stop, disable, and delete the unit file, then reload the daemon. Safe to run even if the service is not currently installed.

dojops-sa svc remove [--system]

status

Show tracked tickets, their current state, and agent status.

dojops-sa status [options]

Output includes ticket reference, status (open, in_progress, in_review, done, failed, skipped, waiting_info), branch name, and PR URL if created.

connectors

Manage ticketing system connectors.

connectors list

Show all configured connectors with their type, URL, and status.

dojops-sa connectors list

connectors add

Add a new connector interactively. Prompts for connector type, URL, credentials, and project key.

dojops-sa connectors add

Supported types: jira, gitlab, github, confluence

connectors remove

Remove a connector by ID.

dojops-sa connectors remove <id>

connectors capabilities

Show the feature matrix for all connector types (tasks, code, comments, transitions, sub-tasks, mentions, knowledge).

dojops-sa connectors capabilities

config

Manage stored credentials and agent configuration.

config set

Store a credential interactively.

dojops-sa config set

config list

Show which credentials and settings are configured.

dojops-sa config list

config remove

Remove a stored credential.

dojops-sa config remove

secrets

Credential rotation and health checks.

secrets rotate

Rotate a connector’s API token. Prompts for the connector and the new token.

dojops-sa secrets rotate

secrets check

Show credential ages and flag stale credentials (older than 90 days).

dojops-sa secrets check

learn

Error pattern mining from execution history.

learn mine

Analyze run history for recurring error patterns. Groups similar errors by fingerprint and tracks occurrence counts.

dojops-sa learn mine

learn list

List discovered error patterns, optionally filtered by repository.

dojops-sa learn list [--repo <repo>]

learn resolve

Mark an error pattern as resolved. Prompts for the pattern and a resolution description.

dojops-sa learn resolve

update

Refresh the local knowledge base from doc.dojops.ai and check for dojops CLI updates.

dojops-sa update

This runs the same maintenance tasks that execute automatically at midnight UTC.

server-id

Generate or display the unique server ID used for offline license binding.

dojops-sa server-id [options]

The server ID is derived from system identity (MAC address, hostname) and stored in the database.