by jonwiggins
Workflow orchestration for AI agent swarms.
# Add to your Claude Code skills
git clone https://github.com/jonwiggins/optioLast scanned: 5/3/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-03T06:27:02.292Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}See how optio compares with popular alternatives.
optio is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by jonwiggins. Workflow orchestration for AI agent swarms. It has 1,067 GitHub stars.
Yes. optio passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/jonwiggins/optio" and add it to your Claude Code skills directory (see the Installation section above).
optio is primarily written in TypeScript. It is open-source under jonwiggins on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh optio against similar tools.
No comments yet. Be the first to share your thoughts!
30 days in the Featured rail · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.

Know what is running, what is ready, and what needs you. All screenshots use fictional demonstration data; activity and usage are simulated.
Optio gives your agents a shared workspace. Hand off a code change, schedule a report, respond to an event, or keep a terminal open while you move between your desk and your phone. Start and follow all of it from one Work feed.
Choose Claude Code, OpenAI Codex, GitHub Copilot, Google Gemini, Cursor, OpenCode, or OpenClaw—or run a plain shell command. Pick the runtime for each piece of work, with the models and providers it supports.
| Put an agent to work on… | Start it with… | What happens |
|---|---|---|
| An issue → a pull request | A prompt, ticket, GitHub event, or Linear event | Work in a repo worktree, open a PR, follow CI and review, and resume with feedback. Merge automatically when configured. |
| Dependency updates and daily briefings | A cron schedule | Run saved instructions on a schedule, with a separate history for each run. |
| Incidents and failed deployments | PagerDuty, Datadog, Alertmanager, Sentry, a failed CI run, or a webhook | Turn event payloads into prompt parameters; investigate with the tools and credentials you assign. |
| Engineering questions and support escalations | Slack or Pylon | Research the request, prepare an answer, and leave the next decision to a person when your instructions call for it. |
| Work in your own checkout | A manual session or an event | Run an agent or terminal on a paired machine with its existing CLI login. |
| A team of specialists | Messages, schedules, or events | Give persistent agents their own instructions and inboxes. Coordinate them through the inter-agent API. |
| Routine shell checks | Manual, schedule, or another trigger | Run a command without an LLM; track its output and exit status. |
| A session with a teammate | An expiring share link | Let an authenticated organization member view and control the session; revoke access when finished. |
The fourteen trigger types are manual, schedule, webhook, ticket, GitHub, GitLab, Slack, Linear, Jira, Pylon, PagerDuty, Sentry, Alertmanager (Prometheus / Grafana), and Datadog. Persistent agents can also wake on messages. GitHub, GitLab, and AWS CodeCommit are supported repository platforms; available CI and issue features depend on the platform.

Repo work, jobs, local automations, and persistent agents share the same feed.
| Your choice | |
|---|---|
| When | Start now, on a schedule, from a ticket or event, or when a message arrives. |
| Where | A pod in your cluster, with or without a repo, or a directory on your machine. |
| Who | An agent runtime with its parameters, or a terminal. |
| What | A prompt, a reusable template with {{params}}, or a shell command. |
| Then | Exit when done, wait for you, or stay available as a persistent agent. |
The form derives the right kind of work from these choices and reads it back as a sentence. Edit recurring work in the same form.

Choose a trigger, then shape the environment: pod or machine, repository and branch, ownership, connections and MCP tools, skills, setup commands, and PR review settings. Follow the repo's defaults or customize this piece of work.
Read the agent’s conversation or use its terminal. Open a shell in the same directory with Terminal here, split sessions side by side, and drag the session sidebar to the width you want. Pane arrangements stay on the current device.

Session sharing requires organization sign-in and grants view and control. Links expire and can be revoked. Collaborators gain access to the session’s environment and capabilities, including credentials available there. Sharing and recovery details →
Optio has a SwiftUI iOS app and a Jetpack Compose Android app. Check the queue, create work, read conversations, control terminals, and manage your workspace from your phone.
iOS: home-screen and Lock Screen widgets, Live Activities, Dynamic Island, and a mirrored Live Activity in the Apple Watch Smart Stack. Android: home-screen widgets, notifications, and an ongoing watch notification. Contextual actions take you back to the work that needs you.

Native Apple component captures with sample states. Watch support is provided by the iPhone Live Activity; there is no separate Watch app.
Build iOS · Build Android · More screenshots
Optio is the orchestration layer you host. Agents still communicate with the model providers and external tools you configure; self-hosting Optio does not make those services local.
For a local deployment, install Docker Desktop and enable Kubernetes, then:
git clone https://github.com/jonwiggins/optio.git
cd optio
./scripts/setup-local.sh
Open http://localhost:30310 and complete setup. The API listens at http://localhost:30400. The setup script builds the project and deploys it to local Kubernetes; see the [installatio