Metadata-Version: 2.4
Name: oficio
Version: 0.3.0
Summary: A calm interface between an Obsidian daily note and Hermes Agent.
Project-URL: Homepage, https://github.com/amphetamarina/oficio
Project-URL: Source, https://github.com/amphetamarina/oficio
Project-URL: Issues, https://github.com/amphetamarina/oficio/issues
Author: Marina Rosa
License-Expression: MIT
License-File: LICENSE
Keywords: agent,automation,hermes,markdown,mcp,obsidian
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Classifier: Topic :: Text Processing :: Markup :: Markdown
Requires-Python: >=3.11
Requires-Dist: mcp>=1.2
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# ofício

Write `- [ ] @agent <request>` in today's Obsidian daily note. Your coding
agent answers in place. That's it.

```markdown
- [x] @agent id:20260520-1 summarize the notes from this meeting.
  Status: completed - summary written | Session: 20260520_…
  Agent response:
  ## Summary
  - The main decision was…
```

Unchecked = open, checked = closed, trace stays visible.

## Setup

Add `oficio-mcp` to your MCP-capable agent (Claude Code, Codex, OpenCode,
Cursor, Continue, Zed, …):

```jsonc
{
  "mcpServers": {
    "oficio": { "command": "uvx", "args": ["--from", "oficio", "oficio-mcp"] }
  }
}
```

That's the whole integration. Eight tools land in your agent
(`oficio_scan`, `oficio_start`, `oficio_complete`, …).

## Optional: trigger automatically from Obsidian

A small companion plugin watches daily notes and launches your agent when it
sees a pending `@agent` task:

```bash
git clone https://github.com/amphetamarina/oficio ~/git/oficio
ln -s ~/git/oficio/obsidian-plugin /path/to/vault/.obsidian/plugins/oficio-trigger
```

Enable **Ofício Trigger** in Obsidian → *Settings → Community plugins*, then
set your agent CLI (`claude`, `codex`, `opencode`, …) in its settings tab.

## Why

ofício keeps the agent inside the texture of daily notes, where context,
memory, and unfinished work already live. One repeated shape — checkbox in,
status + response out — instead of another inbox to remember.

## More

- [DEVELOPMENT.md](DEVELOPMENT.md) — local setup, env vars, tool reference, publishing.
- [AGENTS.md](AGENTS.md) — conventions when an AI agent edits this repo.

MIT.
