Skip to content

Repository files navigation

Taskuary

CI PyPI Python 3.10+ License: MIT

Your inbox, staffed by AI agents

Taskuary turns incoming messages into organized work. It sorts what matters, hands tasks to your agents, and brings decisions back to you. Nothing sends or ships without your approval.

The Taskuary Studio assembling as work arrives and AI agents take their seats.

Taskuary is early—currently v0.3.4.5—so breaking changes are still possible before 1.0.

Try Taskuary now, in your browser

The real app with invented data. Nothing connects, sends, or runs.

What Taskuary can do

Connect every system. Keep control.

Bring your mail, chats, issue trackers, alerts, reports, and AI agents into one control center that runs on your machine. Every input lands on a single Timeline with its context, status, and available actions intact. Taskuary gives your tools one place to work together while you decide what can run, what can send, and what needs your attention.

Taskuary's unified work pipe and chat, populated only with fictional demo data.

Turn incoming work into tasks automatically

AI triage reads every incoming item, understands what it means, and turns actionable requests into ready-to-run tasks. Routine updates are filed, questions get draft replies, and urgent decisions move to the front. Every choice comes with a reason, and you can change it at any time.

Watch the work. Approve the outcome.

Taskuary keeps the system moving and brings you in when your judgment matters. The Assistant speaks up when a reply is waiting, a task has gone quiet, a report has failed, or a meeting is about to start. Each update arrives once, with the evidence and next actions attached, so you can review the work, make the call, and approve what happens next.

Agents in your own repos

Send coding work to Claude Code, Codex, Gemini, Cursor, Copilot, Muse Code, or another CLI. Configure each CLI once under Connections → AI CLI agents: command, arguments, timeout, installation, sign-in and connection tests. Profiles share that connection. Connection cards show installation status separately from configuration. If Windows blocks an installer before it starts, check Windows Security's Protection history for the reason. Install and Update open a terminal beneath the CLI cards, showing commands and live output. You can answer the vendor's prompts there; closing the terminal stops a running installer. Under Docs → Profiles, use Add profile to choose a provider and model, set the worker's instructions, and describe when triage should select it. Leave Available to triage for new tasks on to include it automatically. Each profile starts with editable instructions; coding workers such as Coder and Codex share CODER.md.

Live workspaces

Watch the terminal, answer questions, review changes, and use the built-in browser without losing the session.

Describe a check. Let it run itself.

Say what you want watched in plain words and Taskuary builds it: read a folder of CSVs every morning, total the AP bills due in the next 30 days, count helpdesk tickets by day. Reports read and summarize, on a schedule or on demand, and can come back with an AI summary. Workflows write data and keep state. Quiet checks stay quiet, so the only one you hear about is the one that failed.

You stay in control

Replies and proposed actions wait in Review. You decide what sends, runs, closes, or gets dismissed.

How work flows

1. Work arrives and gets sorted

Taskuary reads connected inboxes, separates tasks from noise, and shows the result on one Timeline.

The Timeline in task view: every message with its verdict, and the drafted reply waiting on you

2. An agent works on it

Tasks move from Queued to Agent working. The Board shows live progress and anything waiting on you.

Taskuary Board with queued, active, and waiting work

3. The result comes back to you

Finished work, draft replies, questions, and loose ends return for review. You decide what to send, change, snooze, or dismiss.

The assistant walking the pipe: the item on the table, its drafted reply, and Approve & send waiting on you

Install

Windows app

Download the latest single-file Taskuary.exe and open it. No Python or installer is required.

Python

Python 3.10 or newer works on Windows, macOS, and Linux:

pip install taskuary
taskuary

Taskuary opens at http://127.0.0.1:7787. For a native desktop window instead, install pip install "taskuary[desktop]" and run taskuary-desktop.

Docker

git clone https://github.com/ldbumble/taskuary
cd taskuary
docker compose up

Then open http://127.0.0.1:7787. Docker runs the web app; coding CLIs and the optional WhatsApp bridge remain on the host.

On first run, connect an AI provider or local Ollama model, add at least one inbound channel, then choose the coding CLI that should receive tasks. The setup wizards test each connection before it goes live.

Try it without installing anything

taskuary --demo                    # or: docker compose --profile demo up

The demo is the real interface with fictional work and scripted replies. It cannot connect to outside systems, send messages, run tools, or start agents. Its changes reset when you reload.

Installs

Daily installs of taskuary from PyPI, mirror traffic excluded

Updated daily from PyPI with mirror traffic excluded. The raw series is docs/downloads.csv.

Documentation

Taskuary is free and open source under the MIT License. Issues and pull requests are welcome; security reports belong in SECURITY.md.

About

Automate your job: local-first AI task hub. Email, Teams, Slack & reports -> one timeline -> AI triage -> your coding agents (Claude Code, Codex, Gemini) do the work, you approve.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

48 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages