Skip to main content

Taskuary

English · 简体中文

CI OpenSSF Scorecard PyPI Python 3.10+ License: MIT

AI agents that work your inbox. You approve what leaves.

Taskuary pulls mail, chats, tickets and reports into one list. An agent works each item - researches, drafts the reply, builds the spreadsheet, fills the form - and hands you one button: Send, Pay, Post. Nothing goes out until you press it.

Runs on your computer. Free, open source, bring your own AI (Claude Code, Codex, Gemini, an API key, or a local model). Early: v0.4.0.17, breaking changes possible before 1.0.

Try the Taskuary demo in your browser   Read the documentation

The Game view: an office where every task, message and agent is a figure - the Agent Floor, the Meeting Room where people wait on you, the Memory Archive and the Assistant Core.

Install

Windows: download the installer. No admin rights, no Python.

Python 3.10+ (Windows, macOS, Linux):

pip install taskuary
taskuary            # opens http://127.0.0.1:7787

Docker: docker compose up. Demo, no AI or accounts: taskuary --demo.

The first run asks for an AI and at least one inbox, and tests each connection before it goes live.

What it does

1. Everything lands in one list

Mail (Gmail, Outlook), chats (Slack, Teams, WhatsApp, Telegram), GitHub, alerts and scheduled reports arrive on one rail, sorted into what needs work, what can wait, and what is just for your information. No more checking six apps.

The work rail sorting the day into Tasks, Reports and FYI, beside the morning card.

2. Every task is one chat

What came in sits on the right, the agent's turns on the left: what it did, the result, and the next step. Type in the box to keep going.

A task as one chat: the request on the right, the agent's turn on the left with what it did and the next step.

3. The agent does the work, not just the summary

It reads the thread, looks things up, uses your systems and a real browser, and comes back with the finished thing: the post with its chart, the reply with the spreadsheet attached, the payment filled in on the vendor's page. Coding work goes to Claude Code, Codex or Gemini.

The agent's turn: what it did, and a LinkedIn post with its chart waiting for one press.

4. You press the last button

Every email, post, push and payment waits as a card. Edit it, send it, or say no. Nothing leaves until you press.

A reply with its workbook attached, waiting on Send.

5. It remembers

Tell it once ("Ray owns the ledger now") and every agent knows from then on. Your edits to its drafts teach it how you write.

LEARNED.md: what Taskuary learned about how you work, each lesson with its evidence.

6. From your phone, too

Work your list over WhatsApp or Telegram, with the same buttons. Plus scheduled reports and dashboards, routines, and saved sign-ins the agent uses without ever seeing the password.

See a full day with Taskuary →

Prompt injection

Taskuary reads text written by strangers, so it assumes some of it is written to steer the AI. No model reliably refuses that, so Taskuary does not rely on the model. It limits what each step can do:

  • Triage has no tools. The model that reads incoming mail can only label it.
  • Strangers don't start agents. An agent works a task by itself only if the sender is trusted: your domain, someone you have written to, or someone you vouched for. Anyone else's task waits for your Trust press. A forged From address (failed DMARC/DKIM) counts as a stranger.
  • Nothing leaves without you. Every email, post, push and payment waits as a card for your press, and is checked again when you approve it. An irreversible step in the browser waits too.
  • The agent never holds a secret. Taskuary types saved passwords itself, and credentials are removed from prompts before they reach a hosted model.
  • Agents have less authority than you inside Taskuary, and a report that reads the open web can read only the files it names.

What it does not do yet: a trusted sender's message can still steer an agent within what that agent is allowed to do. The full model, the limits and what to set: Security.

Privacy

Your data stays in one file on your computer. Only what a task needs goes to the AI you chose; with a local model, nothing leaves. Details: Privacy.

Installs

Daily installs of taskuary from PyPI, mirror traffic excluded

MIT licensed. Issues and pull requests welcome; security reports go to SECURITY.md.

Metadata

Release files for taskuary 0.4.0.17

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for taskuary 0.4.0.17
File Size Uploaded Provenance Actions
taskuary-0.4.0.17.tar.gz 7.5 MB With provenance Details for taskuary-0.4.0.17.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for taskuary 0.4.0.17
File Interpreter ABI Platform Actions
taskuary-0.4.0.17-py3-none-any.whl Python 3 none any Details for taskuary-0.4.0.17-py3-none-any.whl

Total release size: 15.2 MB

Release files / taskuary-0.4.0.17.tar.gz

Download URL taskuary-0.4.0.17.tar.gz
Size 7.5 MB
Tags Source
SHA-256 checksum
How to use checksums
09db191dca13c43a34f22df9ce0d4eadca257338fb3b29aedd1eff89183b2767
BLAKE2b-256 checksum
How to use checksums
c9abc6e4b83df15f075599e4ce2e8c7a57f9cd2c20a7ee89f43959ffc94603cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / taskuary-0.4.0.17-py3-none-any.whl

Download URL taskuary-0.4.0.17-py3-none-any.whl
Size 7.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
192d16efe2eec7d70ebf413aad92cf677ebf8609ee016a3af7af2f362e89b976
BLAKE2b-256 checksum
How to use checksums
48091107e19f8e4ec7a51a65089cb20a8c5977ffe774725ed131f8be1edd4049
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for taskuary 0.4.0.17

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for taskuary-0.4.0.17.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.4.0.17 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page