![]()
Automagik
A team of AI helpers that lives in your chats.
Automagik is superintelligence, in open building blocks: a team of AI agents in your chats,
and each part usable on its own once it ships; Cloud is still in design.
The film: our own GTM team. The team launching Automagik, at work. Music only, no voice-over.
Watch the film on automagik.si
⬇ Download for Mac · ⬇ Download for Linux
Cloud is coming; no date yet. Join the Cloud waitlist on automagik.si
This repository, Genie and Omni are free and open source, Apache-2.0. Cloud is a private, paid service.
Mac with Apple silicon, macOS 13 or newer · Linux on a 64-bit PC · Windows is not supported yet
Two modes
Team mode is the desktop app: a team of long-lived Bots, each with its own name, role, model and memory. They talk to you, to each other and in group chats, run scheduled tasks, and each drives a browser of its own. With an Omni connected, your WhatsApp, Telegram, Slack and other channels sit in the same window, and the Bot you put on a chat acts when something happens there. The team runs on DeepSeek Harness (DSH).
Code mode is your code agents in the real Herdr window, with the Automagik pack: a sidebar of spaces, Bots and workers across coding harnesses. Nothing in Herdr is rebuilt. The app's switch brings the Herdr window forward on the space for the current Bot's folder, and a button in Herdr brings you back. The app download alone does not set Code mode up: it needs Herdr and the pack, and the pack's installer sets up both.
Team mode: the app's switch still says Work.
The seven blocks
Each block is usable alone.
- Team mode (DSH): the Bot team on DeepSeek Harness: long-lived Bots with their own name, role, model and memory, group chats, schedules and the Bot browser.
- Code mode (Herdr): your code agents in the real Herdr window with the Automagik pack; nothing in Herdr is rebuilt.
- Genie: a wish becomes a branch, a test run and a report you approve;
genie desktopopens it on the team. - Omni: the service that links your chat apps to Automagik, with its channels and canvases in the same window.
- Pocket: your coding agents on your Android phone, paired to your own machines.
- The meter: usagemeter, the Rust token meter that records usage and cost on the machine and answers
usagemeter query. - Cloud: one sign-in, organisations and hosted workspaces, with a rail that opens each.
Cloud is designed and accepted, and is not live. When it ships it is a private, paid hosted service: not free and not open source. Only its contracts are public (RFC 0024).
What makes it yours
- Your model. Connect the AI account you already have, or an API key from a provider you use. Each Bot runs on the model you give it.
- Your files and memory, on your computer. What the team keeps is in one folder,
.automagikin your home folder. Each Bot keeps notes across its conversations, each group chat keeps its own, and the team shares one more. Your chats stay in your Omni. What your Bots read and write goes to the AI account you connected, under that company's terms. - Secrets the Bots never see. When a Bot needs an API key, a token or a password, it asks with a card in its own chat. You type the value; the Bot never sees it.
- It asks before it acts as you. Before a Bot sends a message as you to a person, deletes something or disconnects a channel, it shows you exactly what it will do and asks first. The exceptions: your Main Bot and an Omni Bot read your chats and post to a group, a WhatsApp channel or your own chat with yourself without asking. Any other Bot reads and posts only where you allow: the first time it wants a chat it asks, and you answer Once, Always or No; after Always it posts to that group without asking again.
Install
The current release is always at Releases.
Mac (Apple silicon, macOS 13 or newer):
- Download Automagik for Mac.
- Open Automagik-Mac.dmg and drag the Automagik icon onto the Applications folder.
- Open Automagik from Applications.
Linux (64-bit PC):
- Download Automagik for Linux (.deb) for Ubuntu or Debian.
- Double-click it and choose Install, or run
sudo apt install ./Automagik-Linux.deb. - Open Automagik from your apps.
On another Linux, use the AppImage. Windows is not supported yet.
The app has two things to connect when you are ready: an Omni and an AI account. Both can wait. The full guide, updates, your data and uninstall are in apps/desktop. Code mode installs separately: herdr. Pocket: apps/pocket.
This repository
Automagik's plugins for DeepSeek Harness (DSH), and the Automagik desktop app that runs them, with the Herdr pack (herdr/), Pocket (apps/pocket/) and the meter (meter/).
| Folder | Package | What it is |
|---|---|---|
apps/bots-dsh |
@automagik/bots-dsh |
The Bot team: long-lived Bots, group chats, memory, settings, scheduled tasks, the Bot browser. Omni's and Genie's plugins build on it. |
apps/welcome-dsh |
@automagik/welcome-dsh |
The welcome: the octopus, the team step, and Connect AI through DSH's own sign-ins. |
apps/acp-dsh |
@automagik/acp-dsh |
Agents other than DSH's own, over ACP (Agent Client Protocol), as DSH models: the agent's tool calls show as DSH tool cards and ask through DSH's approval dialog (RFC 0003). |
apps/locale-pt-br-dsh |
@automagik/locale-pt-br-dsh |
Português: the Bot team's Brazilian Portuguese under DSH's own Portuguese entry. Adds no language of its own, so Settings › General › Language keeps one Portuguese row; a pt-BR choice saved by an older pack moves to DSH's pt. |
apps/desktop |
(the app) | The Automagik desktop app: DSH of its own with the Bot team, the welcome and Omni's channels and canvases. omni desktop opens it with Omni preloaded, genie desktop with Genie. |
Omni's own plugins (its channels and canvases) live with Omni, in automagik-si/omni (apps/omni-channels-dsh, apps/omni-canvas-dsh), and carry Omni's version.
Install into your own DSH
The desktop app: download it from Releases, or run
omni desktop. See apps/desktop.Into your own DSH: add the Automagik market to DSH's plugin market and install from there:
https://raw.githubusercontent.com/automagik-si/dsh-marketplace/main/index.jsonEvery Omni also serves a market at
https://<your-omni>/api/market/index.jsonwith the release of these plugins it was tested with.
Nothing here is published to npm. The plugins install as git sources pinned to a release commit, or from the tarballs each release carries (plugins.json lists their integrity).
History
@automagik/bots-dsh and @automagik/welcome-dsh were @automagik/omni-dsh and @automagik/omni-ai-dsh in automagik-dev/omni (apps/omni-ui-dsh, apps/omni-ai-dsh), and the desktop app was automagik-dev/omni-desktop. They moved here with their history. What did not change with the names: plugin ids (omni-ui, omni-ai), routes and browser-storage prefixes. From 3.12 the team's home is Automagik's own (~/.automagik/bots, or ~/.automagik/desktop/bots in the app), and the app's identity is Automagik's (ai.namastex.automagik): an app from 3.11.x or before is installed afresh, not updated.
- The Bot team's client bundle also answers to its former name, so channels and canvas plugins built before the rename keep working on it.
- In your own DSH: install
@automagik/bots-dshfrom the market. With both installed, the newer one runs (they share the plugin id); remove@automagik/omni-dshwhen you like. A settings row in your profile'scordis.patch.ymlthat names@automagik/omni-dshneeds itsname:changed to@automagik/bots-dshto keep applying.
Versions and releases
One version for the whole repository, 3.N (semver 3.N.0, N one above the last release: scripts/version.ts), above the 2.x builds omni-desktop released. Every merge into dev is a release: release.yml tags v<version>, publishes the plugin tarballs and plugins.json, builds the desktop app into the same release (desktop-build.yml), lists the release in marketplace/automagik.json, and moves main to it. follow-omni.yml moves the desktop app to each newer Omni release and cuts a release with it.
| Branch | What |
|---|---|
dev |
Integration: pull requests land here; releases are cut from it |
main |
The latest release, moved by release.yml only |
Develop
Bun for the repository's own tooling; the plugins run on Node, as DSH does (node --test, esbuild), with Bun installing them; the desktop app uses npm for Electron.
bun install && bun run check # versions, release tooling, market index
cd apps/bots-dsh && bun install && bun run harness && bun run test
cd apps/welcome-dsh && bun install && bun run harness && bun run test
cd apps/desktop && npm ci && npm test
node scripts/boot-check.mjs # boot the plugins with Omni's in headless Chromium
License
This repository is Apache-2.0. See LICENSE and NOTICE. Genie and Omni are Apache-2.0 in their own repositories. Automagik Cloud is not part of this licence: it is a private, paid service.

No comments yet. Be the first to write one.