{"id":50135801,"url":"https://github.com/dm1tryg/clibo","last_synced_at":"2026-05-23T22:01:20.559Z","repository":{"id":359637799,"uuid":"1246886918","full_name":"dm1tryG/clibo","owner":"dm1tryG","description":"๐Ÿ“ฆ 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.","archived":false,"fork":false,"pushed_at":"2026-05-22T21:49:22.000Z","size":235,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T21:50:05.365Z","etag":null,"topics":["agent-tools","ai-agents","calorie-tracker","cli","crm","habit-tracker","local-first","productivity","python","sqlite","terminal","typer"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dm1tryG.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-22T17:02:35.000Z","updated_at":"2026-05-22T21:49:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dm1tryG/clibo","commit_stats":null,"previous_names":["dm1tryg/clibo"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dm1tryG/clibo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm1tryG%2Fclibo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm1tryG%2Fclibo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm1tryG%2Fclibo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm1tryG%2Fclibo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dm1tryG","download_url":"https://codeload.github.com/dm1tryG/clibo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm1tryG%2Fclibo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33413623,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T18:09:33.147Z","status":"ssl_error","status_checked_at":"2026-05-23T18:09:31.380Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tools","ai-agents","calorie-tracker","cli","crm","habit-tracker","local-first","productivity","python","sqlite","terminal","typer"],"created_at":"2026-05-23T22:00:26.626Z","updated_at":"2026-05-23T22:01:20.540Z","avatar_url":"https://github.com/dm1tryG.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ๐Ÿ“ฆ clibo\n\n### 73 local-first CLI tools for AI agents โ€” and humans\n\n*From a calorie tracker to a CRM. Everything in your terminal, everything in one local SQLite file.*\n\n[![PyPI](https://img.shields.io/pypi/v/clibo.svg)](https://pypi.org/project/clibo/)\n[![CI](https://github.com/dm1tryG/clibo/actions/workflows/ci.yml/badge.svg)](https://github.com/dm1tryG/clibo/actions/workflows/ci.yml)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![Built with Typer](https://img.shields.io/badge/built%20with-Typer%20%2B%20SQLModel-0a7.svg)](https://typer.tiangolo.com/)\n\n\u003c/div\u003e\n\n---\n\n## Install\n\n```bash\npip install clibo # or: pipx install clibo\nuv tool install clibo # (recommended โ€” fast, isolated)\n```\n\nThen:\n\n```bash\nclibo init # one-shot onboarding โ€” currency, goals, etc.\nclibo --help # the full menu\nclibo today # everything actionable today\n```\n\nThat's it โ€” a `clibo` command is on your PATH and a SQLite file lives at\n`~/.clibo/clibo.db`. No account, no cloud, no daemons.\n\n\u003cdetails\u003e\n\u003csummary\u003eOther install methods (development / pre-release)\u003c/summary\u003e\n\n```bash\n# straight from GitHub main\nuv tool install --from git+https://github.com/dm1tryG/clibo.git clibo\npipx install git+https://github.com/dm1tryG/clibo.git\n\n# or the curl one-liner\ncurl -fsSL https://raw.githubusercontent.com/dm1tryG/clibo/main/install.sh | bash\n```\n\n\u003c/details\u003e\n\n---\n\n## Why clibo?\n\nAI agents are great at *deciding* โ€” but they need **tools** to *act*. The most\nuseful tools aren't fancy: they're the boring, everyday ones. Track calories.\nRemember a contact. Add a task. Note an expense.\n\n**clibo** is a box of 50 such tools, each a tiny CLI. They share three things\nthat make them perfect for agents *and* for you:\n\n- ๐Ÿ—„๏ธ **Local-first** โ€” one SQLite file at `~/.clibo/clibo.db`. No cloud, no account, no setup.\n- ๐Ÿค– **Agent-native** โ€” every command speaks `--json`. Pretty tables for humans, clean JSON for machines.\n- ๐ŸŽฏ **One predictable shape** โ€” every tool uses the same verbs: `add`, `list`, `show`, `edit`, `rm`, `stats`.\n\n```bash\nclibo calorie log \"oatmeal with berries\" --kcal 320 --protein 12\nclibo calorie today\nclibo calorie today --json # same data, for your agent\n```\n\n## Demos\n\n[`scripts/demo.sh`](scripts/demo.sh) populates a throwaway database and runs\nthe showcase commands โ€” perfect for recording an asciinema or for seeing\nwhat clibo actually looks like:\n\n```bash\nCLIBO=./.venv/bin/clibo bash scripts/demo.sh\n```\n\n### ๐Ÿ“… `clibo today`\n\n```\n๐Ÿ“… Today ยท Saturday 23 May 2026\n\nโœ… Tasks\n โ— today Ship clibo v1 (high)\n\n๐Ÿ”ฅ Habits 1/2 done\n โœ“ Read 10 pages\n โ—‹ Exercise\n\n ๐Ÿ’ง Water โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 38% 750/2000 ml\n ๐ŸŽ Calories โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 42% 845/2000 kcal\n ๐Ÿ… Focus โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 50% 45/90 min\n\n๐Ÿ“… Events\n 10:00 Team standup\n\n๐Ÿงพ Bills due\n โš  overdue Electricity (2026-05-22)\n\n๐Ÿชด Plants needing water\n Basil (kitchen)\n```\n\n### ๐ŸŽ `clibo calorie today`\n\n```\n๐ŸŽ Food log ยท Sat 23 May\nโ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ•ฎ\nโ”‚Meal โ”‚ Food โ”‚ Kcal โ”‚ Pยทg โ”‚ Cยทg โ”‚ Fยทgโ”‚\nโ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”ค\nโ”‚breakfast โ”‚ oatmeal with berries โ”‚ 320 โ”‚ 12 โ”‚ 48 โ”‚ 6 โ”‚\nโ”‚breakfast โ”‚ black coffee โ”‚ 5 โ”‚ 0 โ”‚ 0 โ”‚ 0 โ”‚\nโ”‚lunch โ”‚ chicken salad โ”‚ 520 โ”‚ 38 โ”‚ 22 โ”‚ 24 โ”‚\nโ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ•ฏ\n๐Ÿ”ฅ 845 kcal ๐Ÿฅฉ 50g ๐Ÿš 70g ๐Ÿงˆ 30g\n๐ŸŽฏ โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 42% 845/2000 kcal\n```\n\n### ๐Ÿงฒ `clibo leads pipeline`\n\n```\n๐Ÿ“Š Pipeline\nโ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ\nโ”‚Stage โ”‚ Deals โ”‚ Value โ”‚\nโ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค\nโ”‚qualified โ”‚ 1 โ”‚ 4000.00 USD โ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 25% โ”‚\nโ”‚proposal โ”‚ 1 โ”‚ 12000.00 USD โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘ 75%โ”‚\nโ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ\n ๐Ÿ’ฐ Open pipeline value: 16000.00 USD\n```\n\n### ๐Ÿ” `clibo search acme`\n\n```\n๐Ÿ” 3 matches for 'acme'\n\nnotes (1) todo (1) crm (1)\nโ•ญโ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ โ•ญโ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ โ•ญโ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ\nโ”‚ID โ”‚ Match โ”‚ โ”‚ID โ”‚ Match โ”‚ โ”‚ID โ”‚ Match โ”‚\nโ”œโ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”œโ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”œโ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค\nโ”‚1 โ”‚ Acme contract โ”‚ โ”‚2 โ”‚ Reply to Acmeโ”‚ โ”‚1 โ”‚ Anna Petrova ยท Acme Incโ”‚\nโ•ฐโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ โ•ฐโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ โ•ฐโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ\n```\n\n## Cross-tool commands\n\nA handful of root commands tie all 73 tools together:\n\n| Command | What it does |\n|---|---|\n| `clibo init` | Set common defaults in one call โ€” currency, height (for BMI), calorie/water/focus/sleep/meditation goals. |\n| `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. |\n| `clibo week` | 7-day rollup: sleep, focus, mood, habits, expenses, journal โ€” plus steps, workouts, caffeine, fasting, meditate, stretches, mileage, gratitude, donations. |\n| `clibo month [-y Y] [-m M]` | Calendar-month rollup: money-first (income vs expenses vs donations + net cash flow), then health \u0026 wellness, productivity, hobbies (books finished, films watched). |\n| `clibo recent` | A chronological activity feed across every tool โ€” newest first, with relative timestamps (\"just now\", \"yesterday\"). |\n| `clibo backup [PATH]` | Copy the local SQLite database to a timestamped `.db` backup (default: `~/.clibo/backups/`). |\n| `clibo restore PATH` | Replace the live database with a backup. |\n| `clibo export [PATH]` | Dump every clibo table to one JSON file โ€” ideal for an agent to read the whole local state in one go. |\n| `clibo import PATH` | Load rows from a `clibo export` JSON file; `--replace` wipes each table first. |\n| `clibo search QUERY` | One query across notes, journal, tasks, bookmarks, contacts, meetings, achievements, recipes, worklog, network, gifts, expenses and the wishlist. |\n| `clibo tags` | Every tag used across notes, todo, bookmark, crm, brag, recipes and journal โ€” with counts and source breakdown. |\n| `clibo doctor` | Health check โ€” version, paths, DB size and row counts per table. |\n\n## Shell completion\n\nclibo ships with completion for `bash`, `zsh` and `fish` โ€” Typer wires it up\nfor you. Install it once:\n\n```bash\nclibo --install-completion # auto-detects your shell\nclibo --install-completion zsh # or pick one explicitly\nclibo --show-completion # print the script (don't install)\n```\n\nThen re-open the shell. You'll get tab-completion for every tool, every\nsub-command and every flag.\n\n## The tools\n\n\u003e ๐ŸŽ‰ **All 73 tools are built.** Run `clibo info` for a live menu.\n\n### ๐Ÿƒ Health \u0026 Wellness\n| | Tool | What it does |\n|---|---|---|\n| โœ… | `calorie` ๐ŸŽ | Food \u0026 calorie tracker with macros |\n| โœ… | `water` ๐Ÿ’ง | Daily water intake tracker |\n| โœ… | `weight` โš–๏ธ | Body-weight log with BMI \u0026 trend |\n| โœ… | `workout` ๐Ÿ‹๏ธ | Exercise \u0026 gym session log |\n| โœ… | `sleep` ๐Ÿ˜ด | Sleep duration \u0026 quality tracker |\n| โœ… | `mood` ๐Ÿ™‚ | Daily mood \u0026 emotion journal |\n| โœ… | `meds` ๐Ÿ’Š | Medication log \u0026 dosage reminders |\n| โœ… | `period` ๐ŸŒธ | Menstrual cycle tracker |\n| โœ… | `meditate` ๐Ÿง˜ | Meditation \u0026 mindfulness sessions |\n| โœ… | `vitals` โค๏ธ | Blood pressure, pulse \u0026 glucose log |\n| โœ… | `stretches` ๐ŸงŽ | Mobility \u0026 flexibility session log |\n| โœ… | `steps` ๐Ÿ‘Ÿ | Daily step-count tracker โ€” goal, streak, by-source totals |\n| โœ… | `caffeine` โ˜• | Caffeine intake with bedtime-residual estimate (half-life model) |\n| โœ… | `fasting` ๐Ÿ•’ | Intermittent-fasting tracker with running clock against target |\n\n### ๐Ÿ’ฐ Money \u0026 Finance\n| | Tool | What it does |\n|---|---|---|\n| โœ… | `expense` ๐Ÿ’ธ | Personal expense tracker |\n| โœ… | `budget` ๐Ÿ“Š | Monthly budgets by category |\n| โœ… | `subs` ๐Ÿ” | Recurring subscriptions tracker |\n| โœ… | `bills` ๐Ÿงพ | Bills \u0026 due-date reminders |\n| โœ… | `savings` ๐Ÿท | Savings goals with progress |\n| โœ… | `debt` ๐Ÿ“‰ | Debt \u0026 loan payoff tracker |\n| โœ… | `networth` ๐Ÿ’ฐ | Assets, liabilities \u0026 net worth |\n| โœ… | `invoice` ๐Ÿ“„ | Freelance invoice generator |\n| โœ… | `split` ๐Ÿค | Split shared expenses with people |\n| โœ… | `wishlist` โญ | Things-to-buy wishlist with prices |\n| โœ… | `income` ๐Ÿ’ต | Income tracker โ€” counterpart to expense |\n| โœ… | `tip` ๐Ÿช™ | Tipping tracker โ€” bill, tip %, venue, service rating |\n| โœ… | `donations` โค๏ธ | Charitable giving log with tax-year and recipient stats |\n| โœ… | `invest` ๐Ÿ“ˆ | Investment positions โ€” buys, sells, cost basis + unrealized P/L |\n\n### โœ… Productivity \u0026 Work\n| | Tool | What it does |\n|---|---|---|\n| โœ… | `todo` โœ… | Task \u0026 to-do manager |\n| โœ… | `notes` ๐Ÿ“ | Quick searchable notes |\n| โœ… | `habit` ๐Ÿ”ฅ | Habit tracker with streaks |\n| โœ… | `focus` ๐Ÿ… | Pomodoro \u0026 focus sessions |\n| โœ… | `time` โฑ๏ธ | Time tracking by project |\n| โœ… | `journal` ๐Ÿ“” | Daily journal \u0026 diary |\n| โœ… | `goals` ๐ŸŽฏ | Goals \u0026 OKRs with milestones |\n| โœ… | `events` ๐Ÿ“… | Events \u0026 reminders calendar |\n| โœ… | `worklog` ๐Ÿ—’๏ธ | Work log \u0026 standup notes |\n| โœ… | `bookmark` ๐Ÿ”– | Bookmarks \u0026 link saver |\n| โœ… | `ideas` ๐Ÿ’ก | Idea capture with lifecycle |\n| โœ… | `challenge` ๐Ÿš€ | Time-boxed challenges with daily check-ins (30-day, 100-day, โ€ฆ) |\n\n### ๐Ÿค CRM \u0026 Relationships\n| | Tool | What it does |\n|---|---|---|\n| โœ… | `crm` ๐Ÿ‘ฅ | Contacts CRM |\n| โœ… | `leads` ๐Ÿงฒ | Sales pipeline \u0026 deals |\n| โœ… | `followup` ๐Ÿ”” | Follow-up reminders for people |\n| โœ… | `meetings` ๐Ÿ—“๏ธ | Meeting notes \u0026 action items |\n| โœ… | `jobs` ๐Ÿ’ผ | Job application tracker |\n| โœ… | `clients` ๐Ÿง‘โ€๐Ÿ’ผ | Freelance client manager |\n| โœ… | `birthdays` ๐ŸŽ‚ | Birthday \u0026 anniversary reminders |\n| โœ… | `network` ๐ŸŒ | Networking \u0026 people-you-met log |\n| โœ… | `gifts` ๐ŸŽ | Gift ideas \u0026 giving tracker |\n| โœ… | `brag` ๐Ÿ† | Achievement log for reviews |\n| โœ… | `cv` ๐Ÿ“œ | Career history โ€” jobs, education, projects, certs |\n\n### ๐Ÿ  Home \u0026 Life\n| | Tool | What it does |\n|---|---|---|\n| โœ… | `groceries` ๐Ÿ›’ | Grocery \u0026 shopping list |\n| โœ… | `pantry` ๐Ÿฅซ | Food inventory with expiry dates |\n| โœ… | `recipes` ๐Ÿ‘จโ€๐Ÿณ | Personal recipe book |\n| โœ… | `meals` ๐Ÿฝ๏ธ | Weekly meal planner |\n| โœ… | `chores` ๐Ÿงน | Household chores rotation |\n| โœ… | `plants` ๐Ÿชด | Plant care \u0026 watering schedule |\n| โœ… | `car` ๐Ÿš— | Car maintenance \u0026 fuel log |\n| โœ… | `home` ๐Ÿ  | Home maintenance \u0026 repairs |\n| โœ… | `pets` ๐Ÿพ | Pet care, feeding \u0026 vet log |\n| โœ… | `travel` โœˆ๏ธ | Trip planner \u0026 itinerary |\n| โœ… | `documents` ๐Ÿ“‘ | Important documents with expiry tracking |\n| โœ… | `packages` ๐Ÿ“ฆ | Shipment \u0026 parcel tracker โ€” pending, late, by carrier |\n\n### ๐ŸŽจ Hobbies \u0026 Culture *(beyond the original 50)*\n| | Tool | What it does |\n|---|---|---|\n| โœ… | `books` ๐Ÿ“š | Reading log with progress \u0026 ratings |\n| โœ… | `films` ๐ŸŽฌ | Movie \u0026 show watchlist with ratings |\n| โœ… | `mileage` ๐Ÿƒ | Running, cycling, walking distance log |\n| โœ… | `gratitude` ๐Ÿ™ | Daily gratitude practice with streaks |\n| โœ… | `quotes` ๐Ÿ’ฌ | A commonplace book of quotes worth keeping |\n| โœ… | `flashcards` ๐Ÿƒ | Spaced-repetition flashcards (Leitner-style) |\n| โœ… | `lessons` ๐Ÿ““ | Lessons learned โ€” context + takeaway |\n| โœ… | `dashboard` ๐ŸŽ›๏ธ | Customizable widget dashboard |\n| โœ… | `dreams` ๐ŸŒ™ | Dream journal with vividness \u0026 symbols |\n| โœ… | `writing` โœ๏ธ | Daily word-count tracker (novel, blog, essays) with goal \u0026 streak |\n\n## For AI agents\n\nEvery command accepts `--json` and returns structured data on stdout. Errors\ngo to stderr with a non-zero exit code. That's the whole contract.\n\n```bash\n$ clibo calorie today --json\n{\n \"date\": \"2026-05-22\",\n \"entries\": [ { \"id\": 1, \"meal\": \"breakfast\", \"food\": \"oatmeal\", \"kcal\": 320, ... } ],\n \"totals\": { \"kcal\": 320, \"protein\": 12.0, \"carbs\": 48.0, \"fat\": 6.0 },\n \"goal_kcal\": 2000\n}\n```\n\nEach tool also ships a **micro-skill** in [`skills/`](skills/) โ€” a short\n`SKILL.md` describing exactly what the tool does and how to call it, ready to\ndrop into an agent's skill set.\n\n[**`AGENTS.md`**](AGENTS.md) is the one-page guide for agents: the contract,\nthe integrating commands (`today` / `search` / `export` / `doctor`), and\ncopy-paste recipes for the most common things you'll want to do.\n\n[**`examples/`**](examples/) has working scripts that build on the contract:\na daily-brief renderer (Python + Bash) and a `search`-then-act agent pattern.\n\n[**`docs/PHILOSOPHY.md`**](docs/PHILOSOPHY.md) explains the seven design\ntrade-offs every clibo tool is built on โ€” read this before suggesting bigger\nchanges.\n\n## Tech\n\nPython ยท [Typer](https://typer.tiangolo.com/) ยท [SQLModel](https://sqlmodel.tiangolo.com/) ยท [Rich](https://rich.readthedocs.io/). One SQLite database. Zero external services.\n\n```\nclibo/\nโ”œโ”€โ”€ clibo/\nโ”‚ โ”œโ”€โ”€ main.py # root command, registers every tool\nโ”‚ โ”œโ”€โ”€ catalog.py # the canonical list of all 73 tools\nโ”‚ โ”œโ”€โ”€ core/ # db, config, settings, output (the shared engine)\nโ”‚ โ””โ”€โ”€ clis/ # one module per tool\nโ”œโ”€โ”€ skills/ # one micro-skill (SKILL.md) per tool\nโ””โ”€โ”€ tests/ # pytest coverage for every tool\n```\n\n## Contributing \u0026 project status\n\nclibo is built in the open, one tool at a time โ€” see [`PLAN.md`](PLAN.md) for\nthe roadmap and [`PROGRESS.md`](PROGRESS.md) for the live log. Adding a tool\nmeans following the shape of [`clibo/clis/calorie.py`](clibo/clis/calorie.py):\na SQLModel table, a Typer `app`, `--json` everywhere, tests, and a `SKILL.md`.\n\n## License\n\n[MIT](LICENSE) ยฉ 2026 dm1tryG\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdm1tryg%2Fclibo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdm1tryg%2Fclibo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdm1tryg%2Fclibo/lists"}