https://github.com/dm1tryg/clibo
📦 50 local-first CLI tools for AI agents and humans — from a calorie tracker to a CRM, all in your terminal. Python · Typer · SQLModel · SQLite.
https://github.com/dm1tryg/clibo
agent-tools ai-agents calorie-tracker cli crm habit-tracker local-first productivity python sqlite terminal typer
Last synced: about 1 month ago
JSON representation
📦 50 local-first CLI tools for AI agents and humans — from a calorie tracker to a CRM, all in your terminal. Python · Typer · SQLModel · SQLite.
- Host: GitHub
- URL: https://github.com/dm1tryg/clibo
- Owner: dm1tryG
- License: mit
- Created: 2026-05-22T17:02:35.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-22T21:49:22.000Z (about 1 month ago)
- Last Synced: 2026-05-22T21:50:05.365Z (about 1 month ago)
- Topics: agent-tools, ai-agents, calorie-tracker, cli, crm, habit-tracker, local-first, productivity, python, sqlite, terminal, typer
- Language: Python
- Size: 229 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📦 clibo
### 73 local-first CLI tools for AI agents — and humans
*From a calorie tracker to a CRM. Everything in your terminal, everything in one local SQLite file.*
[](https://pypi.org/project/clibo/)
[](https://github.com/dm1tryG/clibo/actions/workflows/ci.yml)
[](https://www.python.org/)
[](LICENSE)
[](https://typer.tiangolo.com/)
---
## Install
```bash
pip install clibo # or: pipx install clibo
uv tool install clibo # (recommended — fast, isolated)
```
Then:
```bash
clibo init # one-shot onboarding — currency, goals, etc.
clibo --help # the full menu
clibo today # everything actionable today
```
That's it — a `clibo` command is on your PATH and a SQLite file lives at
`~/.clibo/clibo.db`. No account, no cloud, no daemons.
Other install methods (development / pre-release)
```bash
# straight from GitHub main
uv tool install --from git+https://github.com/dm1tryG/clibo.git clibo
pipx install git+https://github.com/dm1tryG/clibo.git
# or the curl one-liner
curl -fsSL https://raw.githubusercontent.com/dm1tryG/clibo/main/install.sh | bash
```
---
## Why clibo?
AI agents are great at *deciding* — but they need **tools** to *act*. The most
useful tools aren't fancy: they're the boring, everyday ones. Track calories.
Remember a contact. Add a task. Note an expense.
**clibo** is a box of 50 such tools, each a tiny CLI. They share three things
that make them perfect for agents *and* for you:
- 🗄️ **Local-first** — one SQLite file at `~/.clibo/clibo.db`. No cloud, no account, no setup.
- 🤖 **Agent-native** — every command speaks `--json`. Pretty tables for humans, clean JSON for machines.
- 🎯 **One predictable shape** — every tool uses the same verbs: `add`, `list`, `show`, `edit`, `rm`, `stats`.
```bash
clibo calorie log "oatmeal with berries" --kcal 320 --protein 12
clibo calorie today
clibo calorie today --json # same data, for your agent
```
## Demos
[`scripts/demo.sh`](scripts/demo.sh) populates a throwaway database and runs
the showcase commands — perfect for recording an asciinema or for seeing
what clibo actually looks like:
```bash
CLIBO=./.venv/bin/clibo bash scripts/demo.sh
```
### 📅 `clibo today`
```
📅 Today · Saturday 23 May 2026
✅ Tasks
● today Ship clibo v1 (high)
🔥 Habits 1/2 done
✓ Read 10 pages
○ Exercise
💧 Water ███████░░░░░░░░░░░ 38% 750/2000 ml
🍎 Calories ████████░░░░░░░░░░ 42% 845/2000 kcal
🍅 Focus █████████░░░░░░░░░ 50% 45/90 min
📅 Events
10:00 Team standup
🧾 Bills due
⚠ overdue Electricity (2026-05-22)
🪴 Plants needing water
Basil (kitchen)
```
### 🍎 `clibo calorie today`
```
🍎 Food log · Sat 23 May
╭──────────┬──────────────────────┬──────┬─────┬─────┬────╮
│Meal │ Food │ Kcal │ P·g │ C·g │ F·g│
├──────────┼──────────────────────┼──────┼─────┼─────┼────┤
│breakfast │ oatmeal with berries │ 320 │ 12 │ 48 │ 6 │
│breakfast │ black coffee │ 5 │ 0 │ 0 │ 0 │
│lunch │ chicken salad │ 520 │ 38 │ 22 │ 24 │
╰──────────┴──────────────────────┴──────┴─────┴─────┴────╯
🔥 845 kcal 🥩 50g 🍚 70g 🧈 30g
🎯 ██████████░░░░░░░░░░░░░░ 42% 845/2000 kcal
```
### 🧲 `clibo leads pipeline`
```
📊 Pipeline
╭──────────┬───────┬────────────────────────────────────╮
│Stage │ Deals │ Value │
├──────────┼───────┼────────────────────────────────────┤
│qualified │ 1 │ 4000.00 USD ████░░░░░░░░░░░░ 25% │
│proposal │ 1 │ 12000.00 USD ████████████░░░░ 75%│
╰──────────┴───────┴────────────────────────────────────╯
💰 Open pipeline value: 16000.00 USD
```
### 🔍 `clibo search acme`
```
🔍 3 matches for 'acme'
notes (1) todo (1) crm (1)
╭────┬───────────────╮ ╭────┬──────────────╮ ╭────┬────────────────────────╮
│ID │ Match │ │ID │ Match │ │ID │ Match │
├────┼───────────────┤ ├────┼──────────────┤ ├────┼────────────────────────┤
│1 │ Acme contract │ │2 │ Reply to Acme│ │1 │ Anna Petrova · Acme Inc│
╰────┴───────────────╯ ╰────┴──────────────╯ ╰────┴────────────────────────╯
```
## Cross-tool commands
A handful of root commands tie all 73 tools together:
| Command | What it does |
|---|---|
| `clibo init` | Set common defaults in one call — currency, height (for BMI), calorie/water/focus/sleep/meditation goals. |
| `clibo today` | One-screen dashboard pulling from every tool — tasks, habits, meals, events, bills, plus mood, steps, workouts, caffeine, fasting clock, pending challenge check-ins, late packages, and documents expiring soon. |
| `clibo week` | 7-day rollup: sleep, focus, mood, habits, expenses, journal — plus steps, workouts, caffeine, fasting, meditate, stretches, mileage, gratitude, donations. |
| `clibo month [-y Y] [-m M]` | Calendar-month rollup: money-first (income vs expenses vs donations + net cash flow), then health & wellness, productivity, hobbies (books finished, films watched). |
| `clibo recent` | A chronological activity feed across every tool — newest first, with relative timestamps ("just now", "yesterday"). |
| `clibo backup [PATH]` | Copy the local SQLite database to a timestamped `.db` backup (default: `~/.clibo/backups/`). |
| `clibo restore PATH` | Replace the live database with a backup. |
| `clibo export [PATH]` | Dump every clibo table to one JSON file — ideal for an agent to read the whole local state in one go. |
| `clibo import PATH` | Load rows from a `clibo export` JSON file; `--replace` wipes each table first. |
| `clibo search QUERY` | One query across notes, journal, tasks, bookmarks, contacts, meetings, achievements, recipes, worklog, network, gifts, expenses and the wishlist. |
| `clibo tags` | Every tag used across notes, todo, bookmark, crm, brag, recipes and journal — with counts and source breakdown. |
| `clibo doctor` | Health check — version, paths, DB size and row counts per table. |
## Shell completion
clibo ships with completion for `bash`, `zsh` and `fish` — Typer wires it up
for you. Install it once:
```bash
clibo --install-completion # auto-detects your shell
clibo --install-completion zsh # or pick one explicitly
clibo --show-completion # print the script (don't install)
```
Then re-open the shell. You'll get tab-completion for every tool, every
sub-command and every flag.
## The tools
> 🎉 **All 73 tools are built.** Run `clibo info` for a live menu.
### 🏃 Health & Wellness
| | Tool | What it does |
|---|---|---|
| ✅ | `calorie` 🍎 | Food & calorie tracker with macros |
| ✅ | `water` 💧 | Daily water intake tracker |
| ✅ | `weight` ⚖️ | Body-weight log with BMI & trend |
| ✅ | `workout` 🏋️ | Exercise & gym session log |
| ✅ | `sleep` 😴 | Sleep duration & quality tracker |
| ✅ | `mood` 🙂 | Daily mood & emotion journal |
| ✅ | `meds` 💊 | Medication log & dosage reminders |
| ✅ | `period` 🌸 | Menstrual cycle tracker |
| ✅ | `meditate` 🧘 | Meditation & mindfulness sessions |
| ✅ | `vitals` ❤️ | Blood pressure, pulse & glucose log |
| ✅ | `stretches` 🧎 | Mobility & flexibility session log |
| ✅ | `steps` 👟 | Daily step-count tracker — goal, streak, by-source totals |
| ✅ | `caffeine` ☕ | Caffeine intake with bedtime-residual estimate (half-life model) |
| ✅ | `fasting` 🕒 | Intermittent-fasting tracker with running clock against target |
### 💰 Money & Finance
| | Tool | What it does |
|---|---|---|
| ✅ | `expense` 💸 | Personal expense tracker |
| ✅ | `budget` 📊 | Monthly budgets by category |
| ✅ | `subs` 🔁 | Recurring subscriptions tracker |
| ✅ | `bills` 🧾 | Bills & due-date reminders |
| ✅ | `savings` 🐷 | Savings goals with progress |
| ✅ | `debt` 📉 | Debt & loan payoff tracker |
| ✅ | `networth` 💰 | Assets, liabilities & net worth |
| ✅ | `invoice` 📄 | Freelance invoice generator |
| ✅ | `split` 🤝 | Split shared expenses with people |
| ✅ | `wishlist` ⭐ | Things-to-buy wishlist with prices |
| ✅ | `income` 💵 | Income tracker — counterpart to expense |
| ✅ | `tip` 🪙 | Tipping tracker — bill, tip %, venue, service rating |
| ✅ | `donations` ❤️ | Charitable giving log with tax-year and recipient stats |
| ✅ | `invest` 📈 | Investment positions — buys, sells, cost basis + unrealized P/L |
### ✅ Productivity & Work
| | Tool | What it does |
|---|---|---|
| ✅ | `todo` ✅ | Task & to-do manager |
| ✅ | `notes` 📝 | Quick searchable notes |
| ✅ | `habit` 🔥 | Habit tracker with streaks |
| ✅ | `focus` 🍅 | Pomodoro & focus sessions |
| ✅ | `time` ⏱️ | Time tracking by project |
| ✅ | `journal` 📔 | Daily journal & diary |
| ✅ | `goals` 🎯 | Goals & OKRs with milestones |
| ✅ | `events` 📅 | Events & reminders calendar |
| ✅ | `worklog` 🗒️ | Work log & standup notes |
| ✅ | `bookmark` 🔖 | Bookmarks & link saver |
| ✅ | `ideas` 💡 | Idea capture with lifecycle |
| ✅ | `challenge` 🚀 | Time-boxed challenges with daily check-ins (30-day, 100-day, …) |
### 🤝 CRM & Relationships
| | Tool | What it does |
|---|---|---|
| ✅ | `crm` 👥 | Contacts CRM |
| ✅ | `leads` 🧲 | Sales pipeline & deals |
| ✅ | `followup` 🔔 | Follow-up reminders for people |
| ✅ | `meetings` 🗓️ | Meeting notes & action items |
| ✅ | `jobs` 💼 | Job application tracker |
| ✅ | `clients` 🧑💼 | Freelance client manager |
| ✅ | `birthdays` 🎂 | Birthday & anniversary reminders |
| ✅ | `network` 🌐 | Networking & people-you-met log |
| ✅ | `gifts` 🎁 | Gift ideas & giving tracker |
| ✅ | `brag` 🏆 | Achievement log for reviews |
| ✅ | `cv` 📜 | Career history — jobs, education, projects, certs |
### 🏠 Home & Life
| | Tool | What it does |
|---|---|---|
| ✅ | `groceries` 🛒 | Grocery & shopping list |
| ✅ | `pantry` 🥫 | Food inventory with expiry dates |
| ✅ | `recipes` 👨🍳 | Personal recipe book |
| ✅ | `meals` 🍽️ | Weekly meal planner |
| ✅ | `chores` 🧹 | Household chores rotation |
| ✅ | `plants` 🪴 | Plant care & watering schedule |
| ✅ | `car` 🚗 | Car maintenance & fuel log |
| ✅ | `home` 🏠 | Home maintenance & repairs |
| ✅ | `pets` 🐾 | Pet care, feeding & vet log |
| ✅ | `travel` ✈️ | Trip planner & itinerary |
| ✅ | `documents` 📑 | Important documents with expiry tracking |
| ✅ | `packages` 📦 | Shipment & parcel tracker — pending, late, by carrier |
### 🎨 Hobbies & Culture *(beyond the original 50)*
| | Tool | What it does |
|---|---|---|
| ✅ | `books` 📚 | Reading log with progress & ratings |
| ✅ | `films` 🎬 | Movie & show watchlist with ratings |
| ✅ | `mileage` 🏃 | Running, cycling, walking distance log |
| ✅ | `gratitude` 🙏 | Daily gratitude practice with streaks |
| ✅ | `quotes` 💬 | A commonplace book of quotes worth keeping |
| ✅ | `flashcards` 🃏 | Spaced-repetition flashcards (Leitner-style) |
| ✅ | `lessons` 📓 | Lessons learned — context + takeaway |
| ✅ | `dashboard` 🎛️ | Customizable widget dashboard |
| ✅ | `dreams` 🌙 | Dream journal with vividness & symbols |
| ✅ | `writing` ✍️ | Daily word-count tracker (novel, blog, essays) with goal & streak |
## For AI agents
Every command accepts `--json` and returns structured data on stdout. Errors
go to stderr with a non-zero exit code. That's the whole contract.
```bash
$ clibo calorie today --json
{
"date": "2026-05-22",
"entries": [ { "id": 1, "meal": "breakfast", "food": "oatmeal", "kcal": 320, ... } ],
"totals": { "kcal": 320, "protein": 12.0, "carbs": 48.0, "fat": 6.0 },
"goal_kcal": 2000
}
```
Each tool also ships a **micro-skill** in [`skills/`](skills/) — a short
`SKILL.md` describing exactly what the tool does and how to call it, ready to
drop into an agent's skill set.
[**`AGENTS.md`**](AGENTS.md) is the one-page guide for agents: the contract,
the integrating commands (`today` / `search` / `export` / `doctor`), and
copy-paste recipes for the most common things you'll want to do.
[**`examples/`**](examples/) has working scripts that build on the contract:
a daily-brief renderer (Python + Bash) and a `search`-then-act agent pattern.
[**`docs/PHILOSOPHY.md`**](docs/PHILOSOPHY.md) explains the seven design
trade-offs every clibo tool is built on — read this before suggesting bigger
changes.
## Tech
Python · [Typer](https://typer.tiangolo.com/) · [SQLModel](https://sqlmodel.tiangolo.com/) · [Rich](https://rich.readthedocs.io/). One SQLite database. Zero external services.
```
clibo/
├── clibo/
│ ├── main.py # root command, registers every tool
│ ├── catalog.py # the canonical list of all 73 tools
│ ├── core/ # db, config, settings, output (the shared engine)
│ └── clis/ # one module per tool
├── skills/ # one micro-skill (SKILL.md) per tool
└── tests/ # pytest coverage for every tool
```
## Contributing & project status
clibo is built in the open, one tool at a time — see [`PLAN.md`](PLAN.md) for
the roadmap and [`PROGRESS.md`](PROGRESS.md) for the live log. Adding a tool
means following the shape of [`clibo/clis/calorie.py`](clibo/clis/calorie.py):
a SQLModel table, a Typer `app`, `--json` everywhere, tests, and a `SKILL.md`.
## License
[MIT](LICENSE) © 2026 dm1tryG