KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #claude-code #dsh #dsh-plugin #open-source #cli #deepseek-harness #macos #ai-agent

ordinus

★ 103 Open GitHub ↗

Your local-first command center for working with AI agents like a real team.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Ordinus](https://raw.githubusercontent.com/muratgur/ordinus/master/docs/screenshots/hero-banner.gif)

# Ordinus

> A local-first desktop app that lets you compose AI agents from your own Codex / Claude CLIs into scheduled workflows — all your data stays on your machine.

[![Download](https://img.shields.io/badge/download-latest-blue)](https://github.com/muratgur/ordinus/releases/latest)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://raw.githubusercontent.com/muratgur/ordinus/master/LICENSE)
![Electron](https://img.shields.io/badge/Electron-39-47848F?logo=electron&logoColor=white)
![Built with Claude](https://img.shields.io/badge/built%20with-Claude%20Code-d97757)

**Connects to your own accounts —**
![Google](https://img.shields.io/badge/Google-4285F4?logo=google&logoColor=white)
![WhatsApp](https://img.shields.io/badge/WhatsApp-25D366?logo=whatsapp&logoColor=white)
![X](https://img.shields.io/badge/X-000000?logo=x&logoColor=white)
![LinkedIn](https://img.shields.io/badge/LinkedIn-0A66C2?logo=linkedin&logoColor=white)
![Linear](https://img.shields.io/badge/Linear-5E6AD2?logo=linear&logoColor=white)
![Notion](https://img.shields.io/badge/Notion-000000?logo=notion&logoColor=white)
![Atlassian](https://img.shields.io/badge/Atlassian-0052CC?logo=atlassian&logoColor=white)
![Canva](https://img.shields.io/badge/Canva-00C4CC?logo=canva&logoColor=white)
![Datadog](https://img.shields.io/badge/Datadog-632CA6?logo=datadog&logoColor=white)

**Reach your team from your phone —**
![Telegram](https://img.shields.io/badge/Telegram-26A5E4?logo=telegram&logoColor=white)

---

## Download

Pick your platform from the [latest release](https://github.com/muratgur/ordinus/releases/latest):

| Platform | File |
|---|---|
| **macOS** (Apple Silicon) | `Ordinus-<version>.dmg` |
| **Windows** (x64) | `ordinus-<version>-setup.exe` |

> Builds are unsigned for now, so your OS will warn you before launching. The app is fully local-first — nothing is uploaded anywhere.

### First launch — macOS

The 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.

1. 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).
2. In Terminal, strip the quarantine attribute, then launch:

```bash
   xattr -dr com.apple.quarantine /Applications/Ordinus.app
   open /Applications/Ordinus.app
   ```

You only do this once. After the first launch, the app opens normally.

### First launch — Windows

SmartScreen will show **"Windows protected your PC"**. Click **More info** → **Run anyway**.

The installer puts Ordinus under `Program Files` and creates a Start Menu / Desktop shortcut. Subsequent launches open without prompts.

## What it does

![Agents](https://raw.githubusercontent.com/muratgur/ordinus/master/docs/screenshots/agents.png)

**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.

![Workflow Designer](https://raw.githubusercontent.com/muratgur/ordinus/master/docs/screenshots/workflow-designer.png)

**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.

![Workboard](https://raw.githubusercontent.com/muratgur/ordinus/master/docs/screenshots/workboard.png)

**Workboard.** Watch tasks execute, inspect provider output, and steer runs in flight.

## Connections

![Connections](https://raw.githubusercontent.com/muratgur/ordinus/master/docs/screenshots/connections.png)

Give your agents the tools you already use — each connection runs under **your own account**, with credentials stored encrypted on your machine.

**Your accounts, run locally**

- **Google** — read Gmail, Calendar, and Drive (sending email or creating events is opt-in, off by default)
- **WhatsApp** — read incoming messages and reply, via device pairing
- **X (Twitter)** — read your timeline and mentions; posting is opt-in
- **LinkedIn** — read profiles, companies, and posts

**Hosted services (OAuth)**

- **Linear**, **Notion**, **Atlassian** (Jira / Confluence), **Canva**, **Datadog**

**Reach your team from anywhere**

- **Telegram** — pair your own bot to message your agents from your phone and get the work sent back, no laptop needed (Settings → Remote Access)

Nothing 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.

## Why local-first

- Your prompts, conversations, and workflow definitions live in a local SQLite database — no cloud account, no per-seat pricing.
- Providers run as local CLI processes (Codex, Claude). Ordinus orchestrates them; it does not proxy your tokens through a third-party service.
- No telemetry. No phone-home.

## Build from source

Requires Node.js `22.13.0+` and the platform toolchains electron-builder needs.

```bash
git clone https://github.com/muratgur/ordinus.git
cd ordinus/app
npm ci
npm run dev          # run in dev mode
npm run build:mac    # produce a .dmg under app/dist
npm run build:win    # produce a .exe installer under app/dist
```

For Windows builds on a non-signing machine, use `npm run build:win:local`.

## Use cases

Real projects built end-to-end with Ordinus — original prompt, agent crew, workflows, and what came out.

[**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.

[Browse all use cases →](use-cases/)

## Status

Ordinus 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.

## Built with Claude Code

This 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.

## Documentation

- [Architecture](docs/architecture.md)
- [Provider runtime contract](docs/provider-runtime-contract.md)
- [Packaging & release](docs/packaging-release.md)
- [Product brief](docs/product-brief.md)
- [Agent guide](AGENTS.md)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). Small, well-scoped changes are easiest to land.

## Security

See [SECURITY.md](SECURITY.md) for private vulnerability reporting.

## License

ordinus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README