{"id":50895259,"url":"https://github.com/muratgur/ordinus","last_synced_at":"2026-06-16T00:00:21.213Z","repository":{"id":362724837,"uuid":"1232650857","full_name":"muratgur/ordinus","owner":"muratgur","description":"Your local-first command center for working with AI agents like a real team.","archived":false,"fork":false,"pushed_at":"2026-06-13T13:04:41.000Z","size":17642,"stargazers_count":79,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-06-13T14:23:14.724Z","etag":null,"topics":["agent-orchestration","ai-agents","claude","codex","desktop","electron","gemini","local-first","typescript","workflow-engine"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/muratgur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-08T06:19:36.000Z","updated_at":"2026-06-13T13:02:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/muratgur/ordinus","commit_stats":null,"previous_names":["muratgur/ordinus"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/muratgur/ordinus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muratgur%2Fordinus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muratgur%2Fordinus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muratgur%2Fordinus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muratgur%2Fordinus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muratgur","download_url":"https://codeload.github.com/muratgur/ordinus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muratgur%2Fordinus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34385031,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-orchestration","ai-agents","claude","codex","desktop","electron","gemini","local-first","typescript","workflow-engine"],"created_at":"2026-06-16T00:00:20.035Z","updated_at":"2026-06-16T00:00:21.190Z","avatar_url":"https://github.com/muratgur.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Ordinus](docs/screenshots/hero-banner.gif)\n\n# Ordinus\n\n\u003e A local-first desktop app that lets you compose AI agents from your own Codex / Claude / Gemini CLIs into scheduled workflows — all your data stays on your machine.\n\n\u003c!-- TODO: replace placeholder pitch above with final wording --\u003e\n\n[![Download](https://img.shields.io/badge/download-latest-blue)](https://github.com/muratgur/ordinus/releases/latest)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n![Electron](https://img.shields.io/badge/Electron-39-47848F?logo=electron\u0026logoColor=white)\n![Built with Claude](https://img.shields.io/badge/built%20with-Claude%20Code-d97757)\n\n**Connects to your own accounts —**\n![Google](https://img.shields.io/badge/Google-4285F4?logo=google\u0026logoColor=white)\n![WhatsApp](https://img.shields.io/badge/WhatsApp-25D366?logo=whatsapp\u0026logoColor=white)\n![X](https://img.shields.io/badge/X-000000?logo=x\u0026logoColor=white)\n![LinkedIn](https://img.shields.io/badge/LinkedIn-0A66C2?logo=linkedin\u0026logoColor=white)\n![Linear](https://img.shields.io/badge/Linear-5E6AD2?logo=linear\u0026logoColor=white)\n![Notion](https://img.shields.io/badge/Notion-000000?logo=notion\u0026logoColor=white)\n![Atlassian](https://img.shields.io/badge/Atlassian-0052CC?logo=atlassian\u0026logoColor=white)\n![Canva](https://img.shields.io/badge/Canva-00C4CC?logo=canva\u0026logoColor=white)\n![Datadog](https://img.shields.io/badge/Datadog-632CA6?logo=datadog\u0026logoColor=white)\n\n**Reach your team from your phone —**\n![Telegram](https://img.shields.io/badge/Telegram-26A5E4?logo=telegram\u0026logoColor=white)\n\n---\n\n## Download\n\nPick your platform from the [latest release](https://github.com/muratgur/ordinus/releases/latest):\n\n| Platform | File |\n|---|---|\n| **macOS** (Apple Silicon) | `Ordinus-\u003cversion\u003e.dmg` |\n| **Windows** (x64) | `ordinus-\u003cversion\u003e-setup.exe` |\n\n\u003e Builds are unsigned for now, so your OS will warn you before launching. The app is fully local-first — nothing is uploaded anywhere.\n\n### First launch — macOS\n\nThe DMG is unsigned, so macOS Gatekeeper will refuse to open it with a misleading **\"Ordinus is damaged and can't be opened\"** message. The app is not damaged — Gatekeeper just blocks unsigned apps that carry the quarantine attribute set by your browser.\n\n1. Open the `.dmg` and **drag `Ordinus.app` onto the `Applications` shortcut** (don't double-click the icon inside the DMG window — that runs it from a read-only volume).\n2. In Terminal, strip the quarantine attribute, then launch:\n\n   ```bash\n   xattr -dr com.apple.quarantine /Applications/Ordinus.app\n   open /Applications/Ordinus.app\n   ```\n\nYou only do this once. After the first launch, the app opens normally.\n\n### First launch — Windows\n\nSmartScreen will show **\"Windows protected your PC\"**. Click **More info** → **Run anyway**.\n\nThe installer puts Ordinus under `Program Files` and creates a Start Menu / Desktop shortcut. Subsequent launches open without prompts.\n\n## What it does\n\n![Agents](docs/screenshots/agents.png)\n\n**Agents.** Compose roles (article writer, code reviewer, security engineer, …) backed by your local AI CLIs. Each agent has a profile, capabilities, and its own conversation space.\n\n![Workflow Designer](docs/screenshots/workflow-designer.png)\n\n**Workflow Designer.** Visually wire agents and tasks into a DAG. Compiles down to a runnable plan; reuse the same engine across manual runs and schedules.\n\n![Workboard](docs/screenshots/workboard.png)\n\n**Workboard.** Watch tasks execute, inspect provider output, and steer runs in flight.\n\n## Connections\n\n![Connections](docs/screenshots/connections.png)\n\nGive your agents the tools you already use — each connection runs under **your own account**, with credentials stored encrypted on your machine.\n\n**Your accounts, run locally**\n\n- **Google** — read Gmail, Calendar, and Drive (sending email or creating events is opt-in, off by default)\n- **WhatsApp** — read incoming messages and reply, via device pairing\n- **X (Twitter)** — read your timeline and mentions; posting is opt-in\n- **LinkedIn** — read profiles, companies, and posts\n\n**Hosted services (OAuth)**\n\n- **Linear**, **Notion**, **Atlassian** (Jira / Confluence), **Canva**, **Datadog**\n\n**Reach your team from anywhere**\n\n- **Telegram** — pair your own bot to message your agents from your phone and get the work sent back, no laptop needed (Settings → Remote Access)\n\nNothing about your data leaves your machine — Ordinus never collects, uploads, or shares it. Tools that act on the outside world (send a message, post, create an event) ship disabled; you turn each one on yourself from Settings → Connections.\n\n## Why local-first\n\n- Your prompts, conversations, and workflow definitions live in a local SQLite database — no cloud account, no per-seat pricing.\n- Providers run as local CLI processes (Codex, Claude, Gemini). Ordinus orchestrates them; it does not proxy your tokens through a third-party service.\n- No telemetry. No phone-home.\n\n## Build from source\n\nRequires Node.js `22.13.0+` and the platform toolchains electron-builder needs.\n\n```bash\ngit clone https://github.com/muratgur/ordinus.git\ncd ordinus/app\nnpm ci\nnpm run dev          # run in dev mode\nnpm run build:mac    # produce a .dmg under app/dist\nnpm run build:win    # produce a .exe installer under app/dist\n```\n\nFor Windows builds on a non-signing machine, use `npm run build:win:local`.\n\n## Use cases\n\nReal projects built end-to-end with Ordinus — original prompt, agent crew, workflows, and what came out.\n\n[**Shape Survivor**](use-cases/shape-survivor/) — a complete Godot Brotato-like with 6 characters, 7 weapons, 8 waves, and a boss, built in ~12 hours by a 6-agent crew across 142 tasks. Zero human-written code.\n\n[Browse all use cases →](use-cases/)\n\n## Status\n\nOrdinus is pre-1.0. APIs, schemas, and the UI may change between releases. The 0.x line is a public showcase — feedback welcome, but breaking changes will happen without ceremony.\n\n## Built with Claude Code\n\nThis project is developed AI-assisted using [Claude Code](https://claude.ai/code). The `.claude/skills/` directory contains the project-specific skills (architecture guides, IPC contracts, secure-boundary rules, etc.) that shape how the AI collaborates on the codebase. If you're curious about agent-assisted development workflows, those files are worth a read.\n\n## Documentation\n\n- [Architecture](docs/architecture.md)\n- [Provider runtime contract](docs/provider-runtime-contract.md)\n- [Packaging \u0026 release](docs/packaging-release.md)\n- [Product brief](docs/product-brief.md)\n- [Agent guide](AGENTS.md)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). Small, well-scoped changes are easiest to land.\n\n## Security\n\nSee [SECURITY.md](SECURITY.md) for private vulnerability reporting.\n\n## License\n\n[MIT](LICENSE) © 2026 Murat Gür\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuratgur%2Fordinus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuratgur%2Fordinus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuratgur%2Fordinus/lists"}