Guides
Guides
Step-by-step instructions for configuring, operating, and extending Sortie.
Setup & configuration
API authentication, state mapping, and JQL filters.
Token setup, label filters, and state mapping.
Test workflows without a real tracker.
Go text/template with issue fields and helpers.
Run scripts before and after agent sessions.
Session budgets, backoff, and skip rules.
Run tests and let the agent review its own diff before opening a PR.
Run gitleaks, semgrep, and govulncheck.
Separate processes for different projects.
One Sortie instance per repository.
Route issues to agents and templates by label, type, or priority.
Operations
What survives restarts and how recovery works.
Per-session budgets, turn caps, and concurrency.
Run as a persistent service on Linux.
Run as a persistent service on macOS.
Distribute sessions across remote machines.
Enable post-PR feedback loops and auto-merge.
Detect CI failures and retry automatically.
Route PR review comments back to the agent as continuation context.
Observability
Deployment
Advanced
Use sortie_status and other tools in templates.
Run coding agent sub-agents with zero config.
Implement the AgentTool interface step by step.
Implement the AgentAdapter interface for a new coding agent.