Skip to main content

Attaché

A personal assistant you install with one command. It runs on your own machine, keeps your to-dos and reminders, makes interactive pages on demand, and learns how you work through a folder of skills it can edit itself. The core is under 2,700 lines of Python code, the cap CI enforces; everything else is a skill.

Status: phase 3 of the roadmap: the local core, terminal and web chat; Slack and Signal with group chats, approvals and rate limits; email (Outlook, Gmail, Titan) with a morning triage; email requests from people you list, for your free slots or a job you defined; Word, Excel and PowerPoint files; share links; and starting at login. The cloud arrives in phase 4.

Documentation: https://openafterhours.github.io/attache/.

Try it

uvx attache              # first run asks your name, creates ~/.attache, then opens a chat
uv tool install attache  # keep it
attache chat             # terminal chat, plus the web page
attache run              # web page, reminders and channels, no terminal chat
attache doctor           # check your setup
attache skill mail login gmail   # a skill's own setup step, run in your terminal
attache skill service install    # start Attaché when you log in
attache skill tui                # a full-screen terminal app (docs/terminal.md)

While a turn runs, the terminal shows what Attaché is doing: working…, each step with its time, a line of Claude's thinking, and a footer with time and tokens. Ctrl+C stops a turn.

The resizable web workspace, with chat beside Tasks and tabs for Pages, Analysis, Activity and Settings

The terminal and the web page are one conversation. Attaché prints a link like http://127.0.0.1:8765/#t=... when it starts; open that link to use the web page. The token in it changes every run, so other programs on your machine can't drive your assistant.

The web workspace has Chat, Split and Workspace layouts with a resizable divider. Switch between tasks, saved pages, activity and owner-only Settings; your draft and open pages stay in place. Settings validates and previews changes before saving, preserves file-managed options, and shows when a restart is needed.

The optional analysis skill connects the same conversation to a Hailer notebook. Saved result pages appear in the workspace; the live notebook opens separately.

Attaché talks to models through four adapters, chosen in ~/.attache/attache.toml:

api Use it for
claude-cli Claude Code (claude -p) on your own login. Your own chats only.
anthropic The Claude API, or any Anthropic-compatible base_url
openai-chat Ollama, LM Studio, vLLM, llama.cpp, OpenRouter, Groq, Azure
openai-responses OpenAI reasoning models with tools
[routing]
own_chats   = "claude"      # your Claude login
group_chats = "claude-api"  # an API key, per Anthropic's terms

[endpoints.claude]
api   = "claude-cli"
model = "claude-sonnet-5-5"

[endpoints.claude-api]
api     = "anthropic"
model   = "claude-sonnet-5-5"
key_env = "ANTHROPIC_API_KEY"

How it is put together

  • Skills live in ~/.attache/skills/<name>/SKILL.md (Agent Skills format). Only names and descriptions go into the prompt. The assistant edits skills when you change how you work, and ~/.attache is a git repo, so attache skills log and attache skills undo <name> show and reverse every change.
  • Artifacts are HTML pages the assistant writes into ~/.attache/artifacts/. The local web server adds a small attache bridge so a page can read and write real data with live updates. Pages run sandboxed: they can't reach the internet or anything outside the data they declare.
  • Channels. Slack and Signal are skills that ship a small program, a sidecar, which Attaché starts with uv run and talks to over JSON lines. Any chat app can be added the same way: see docs/channels.md.
  • Mail is one skill with the same commands for Outlook (Outlook classic on this PC, or Microsoft Graph), Gmail and Titan. Bodies come back marked untrusted, every action is logged, and nothing is sent until you pick Send: see docs/mail.md.
  • Email requests. People you list can write @attache in an email to you. Attaché checks the message really came from them (DMARC), then answers in the thread: free slots from your diary, never what is in it (docs/diary.md), or a job you defined, run in the background, with "done" or "failed" back to them and the details to you (docs/jobs.md). Setup is in docs/channels.md.
  • Share links. With [web] public_url set and Tailscale Funnel pointed at a second local port, a group's page gets a link that works on anyone's phone, for that group's shared data only: see docs/pages.md.
  • Roles. You are the owner. Group members only reach what is shared with their chat, and never files, shell or email. Your own turns inside a group get member tools too, because the group's messages are untrusted. When a member asks for something only you can do, Attaché asks you first (buttons on Slack and the web page, a reaction or a typed reply elsewhere).
  • Claude Code runs as a backend with claude -p on your own login, for your own chats only. Attaché's tools reach it through an MCP endpoint on the local web server. It runs in a working folder next to your home (~/.attache-claude), so nothing written into ~/.attache can load as Claude Code project settings.

The full design, with the research behind it, is in docs/proposal.html.

Contributing

See CONTRIBUTING.md: bug fixes and simplifications go in the core, features go in skills.

License

MIT

Metadata

Release files for attache 0.0.4

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

Source distribution (sdist)

Source distribution for attache 0.0.4
File Size Uploaded Provenance Actions
attache-0.0.4.tar.gz 892.4 kB With provenance Details for attache-0.0.4.tar.gz

Built distribution (wheel)

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

Total release size: 1.3 MB

Release files / attache-0.0.4.tar.gz

Download URL attache-0.0.4.tar.gz
Size 892.4 kB
Tags Source
SHA-256 checksum
How to use checksums
c25a61095ffa53f8d9e486e69cc26988e88200c4c011b6dcd1c39b6232a32ffd
BLAKE2b-256 checksum
How to use checksums
5a18c1ae351512737463b7e5725a8b929e71abc62a2113615294dba6bf0c3d15
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 Oct 22, 2026.

Transparency log

Release files / attache-0.0.4-py3-none-any.whl

Download URL attache-0.0.4-py3-none-any.whl
Size 425.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
190f253ddad1891e7c0959ff17e39c821da434a65c8c6797974375872ab48cf4
BLAKE2b-256 checksum
How to use checksums
fb5c4d6e174496f69d967ab91aa8d090e0160ba8ff7a509fd92b8b405c3d41fc
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 Oct 22, 2026.

Transparency log

Security for attache 0.0.4

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 attache-0.0.4.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 Oct 22, 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.

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