Install

pip install clibo          # or: pipx install clibo
uv tool install clibo      # (recommended — fast, isolated)

Then:

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.

# 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.

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 populates a throwaway database and runs the showcase commands — perfect for recording an asciinema or for seeing what clibo actually looks like:

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 74 tools together:

Shell completion

clibo ships with completion for bash, zsh and fish — Typer wires it up for you. Install it once:

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 74 tools are built. Run clibo info for a live menu.

🏃 Health & Wellness

💰 Money & Finance

✅ Productivity & Work

🤝 CRM & Relationships

🏠 Home & Life

🎨 Hobbies & Culture (beyond the original 50)

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.

$ 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/ — 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 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/ has working scripts that build on the contract: a daily-brief renderer (Python + Bash) and a search-then-act agent pattern.

docs/PHILOSOPHY.md explains the seven design trade-offs every clibo tool is built on — read this before suggesting bigger changes.

Tech

Python · Typer · SQLModel · Rich. One SQLite database. Zero external services.

clibo/
├── clibo/
│   ├── main.py          # root command, registers every tool
│   ├── catalog.py       # the canonical list of all 74 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 for the roadmap and PROGRESS.md for the live log. Adding a tool means following the shape of clibo/clis/calorie.py: a SQLModel table, a Typer app, --json everywhere, tests, and a SKILL.md.

License

MIT © 2026 dm1tryG