Metadata-Version: 2.5
Name: attache
Version: 0.0.1
Summary: A personal assistant you install with one command. Small core; channels, email and file formats are skills.
Project-URL: Homepage, https://github.com/OpenAfterHours/attache
Project-URL: Repository, https://github.com/OpenAfterHours/attache
Project-URL: Issues, https://github.com/OpenAfterHours/attache/issues
Author: OpenAfterHours contributors
License-Expression: MIT
License-File: LICENSE
Keywords: agent,assistant,claude,local-first,openai,skills
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Scheduling
Requires-Python: >=3.11
Requires-Dist: anthropic>=0.40
Requires-Dist: cronsim>=2.6
Requires-Dist: openai>=1.66
Requires-Dist: pyyaml>=6
Requires-Dist: starlette>=0.40
Requires-Dist: uvicorn>=0.30
Description-Content-Type: text/markdown

# 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 just under 1,600 lines of Python code, the
cap CI enforces; everything else is a skill.

> **Status:** phase 1 of the [roadmap](docs/proposal.html): the local core, terminal and web
> chat. Slack and Signal arrive in phase 2, email (Outlook, Gmail, Titan) in phase 3.

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

![The web page: chat on the left, the Home page with to-dos and reminders on the right](docs/phase-1-ui.png)

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.

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                                |

```toml
[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](https://agentskills.io)
  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.
- **Roles.** You are the owner. Group members (from phase 2) 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.
- **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](docs/proposal.html).

## Contributing

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

## License

MIT
