Zenobs is a tool for managing your inbox and projects.
Project description
zenobs
zenobs is a small CLI that pairs an Obsidian-style vault with an AI agent. It helps you manage tasks, projects, meetings, people notes, and a per-project inbox from the terminal.
Features
- Interactive chat (
zo chat) — talk to the agent about your vault; it can read context and create or update tasks, projects, meetings, and people. - Inbox processing (
zo inbox) — the agent reads quick notes grouped by project, turns them into the right vault updates, and marks inbox entries as handled so they are not processed again.
The agent is built with pydantic-ai and uses Google Gemini (see MODEL in zenobs/agent.py).
Requirements
- Python 3.12 or newer
- A vault directory on disk: each top-level folder (except ignored names like
Inbox,inbox,.obsidian,People) is treated as a project; vault-level people live underPeople/as Markdown notes.
Configure Google Gemini API access the way pydantic-ai expects for the google-gla provider (for example API keys or Vertex, depending on your setup). See the pydantic-ai documentation for provider configuration.
Installation
From the repository root, install in editable mode (recommended while developing):
pip install -e .
This exposes the zo command (see [project.scripts] in pyproject.toml).
Usage
Run commands from your vault root (the folder VaultManager uses as dir_path — typically the current working directory).
zo chat # interactive session
zo inbox # process the inbox with the agent
License
MIT — see pyproject.toml for authorship.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file zenobs-0.1.0.tar.gz.
File metadata
- Download URL: zenobs-0.1.0.tar.gz
- Upload date:
- Size: 148.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
366be9579ece22b418b0dcdb12267e8a5c58f98dc254d03b4e16696d75c3018e
|
|
| MD5 |
8e940e62ad1ae006335197212c5c60d4
|
|
| BLAKE2b-256 |
9272778f52f58cea16932bda71415676cb4028bdf3f9b2b06be9fb9480e20c46
|
File details
Details for the file zenobs-0.1.0-py3-none-any.whl.
File metadata
- Download URL: zenobs-0.1.0-py3-none-any.whl
- Upload date:
- Size: 17.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7299ef69cf59a0005049ff7d71a8a6841ac93ef8220712c6d0240d77f0d19b65
|
|
| MD5 |
04f56f4c269fe6777408f9b0f2de939e
|
|
| BLAKE2b-256 |
8a4875014ea01c89cb16ddffd0cb4d7b6838c24b76df61fba9649033860ddff7
|
