![\"DailyHub](\"docs/assets/banner.png\")
\n \n\n \n \n \n
\n ![\"npm](\"https://img.shields.io/npm/v/@baselhusam/daily-hub?style=flat&color=2383E2\")
![\"Docker](\"https://img.shields.io/docker/v/baselhusam/daily-hub?sort=semver&style=flat&logo=docker&label=Docker%20Hub&color=2496ED\")
![\"CI\"](\"https://img.shields.io/github/actions/workflow/status/baselhusam/daily-hub/ci.yml?style=flat&label=CI\")
![\"MIT](\"https://img.shields.io/github/license/baselhusam/daily-hub?style=flat&color=37352F\")
![\"Node.js\"](\"https://img.shields.io/node/v/@baselhusam/daily-hub?style=flat\")
![\"TypeScript\"](\"https://img.shields.io/badge/TypeScript-5-3178C6?style=flat&logo=typescript&logoColor=white\"){kind=icon}
\n Website\n ·\n npm\n ·\n Docker Hub\n ·\n GHCR\n ·\n Docs\n ·\n Changelog\n ·\n Author\n
\n\n---\n\nA personal command center for people who juggle **more than one project at a time** — founders, consultants, indie builders, anyone with client work, side projects, and a few non-negotiable daily habits.\n\nDailyHub is not a replacement for Linear, Jira, or Notion. It is the **morning surface**: what is open, what belongs where, what must happen today, and what you already finished.\n\n## See it in action\n\n\n \n
\n\n## Features\n\n- **Today** — greeting, quick add, nudges, today’s habits, open work by project, and an inbox\n- **Projects** — status, due dates, milestones, and stalled-work banners\n- **Habits** — weekday schedules, 14-day consistency, and completion rate\n- **Analytics** — completions over time, project breakdown, and weekday patterns\n- **Command palette** — jump to projects, tasks, habits, and milestones\n- **Local by default** — SQLite on disk, light and dark themes, no accounts\n\n## Quick start\n\nRequires [Node.js 22+](https://nodejs.org/).\n\n```bash\nnpx @baselhusam/daily-hub\n```\n\nOpens [http://127.0.0.1:9999](http://127.0.0.1:9999). Data lives in `~/.daily-hub/` (`data.db` and `uploads/`). The first download is ~80 MB because the package ships the full Next.js app; later runs are instant.\n\n```bash\nnpx @baselhusam/daily-hub --seed # sample data on first run\nnpx @baselhusam/daily-hub --port 3000 # different port\nnpx @baselhusam/daily-hub --data-dir ~/my-hub # custom data directory\nnpx @baselhusam/daily-hub --no-open # don't open the browser\nnpx @baselhusam/daily-hub --no-mcp # disable the local MCP endpoint\nnpx @baselhusam/daily-hub --detach # run in the background\nnpx @baselhusam/daily-hub --update # run the latest published version\n```\n\n`--update` (or `update`) fetches and runs the latest published DailyHub release. Any other options are preserved, so `npx @baselhusam/daily-hub --update --port 3000` updates and starts it on port 3000.\n\n`--detach` starts DailyHub in the background, opens the app when it is ready, and lets you close the terminal. Manage that instance later with:\n\n```bash\nnpx @baselhusam/daily-hub status\nnpx @baselhusam/daily-hub logs\nnpx @baselhusam/daily-hub stop\n```\n\nThe background process and log are recorded in the selected data directory (`~/.daily-hub/` by default); pass the same `--data-dir` to the management commands if you use a custom location. It remains running until stopped or the computer restarts; use Docker or a system service if you need automatic restarts.\n\n### MCP integration\n\nDailyHub starts a local, token-protected MCP endpoint by default at `/mcp` on the selected app port. After starting the app, print a ready-to-copy client configuration with:\n\n```bash\nnpx @baselhusam/daily-hub mcp\n```\n\nThe endpoint is bound to `127.0.0.1` and requires the bearer token in that output. The token is stored with owner-only permissions in `~/.daily-hub/daily-hub-mcp.json`. Disable the endpoint for a launch with `--no-mcp`.\n\nDo not keep `~/.daily-hub/` in iCloud, Dropbox, or other file-sync folders — SQLite and file sync can corrupt the database. Backup is a copy of that folder (or your `--data-dir`).\n\n### Docker\n\n```bash\ndocker run -d --name dailyhub -p 9999:9999 \\\n -v dailyhub_data:/app/data \\\n baselhusam/daily-hub:latest\n```\n\nOpen [http://localhost:9999](http://localhost:9999). Data persists in the `dailyhub_data` volume. The command above pulls from [Docker Hub](https://hub.docker.com/r/baselhusam/daily-hub); pin a version with `baselhusam/daily-hub:X.Y.Z` (same as the npm version). The same tags are also published to [GHCR](https://github.com/baselhusam/daily-hub/pkgs/container/daily-hub) as `ghcr.io/baselhusam/daily-hub`. Optional sample data:\n\n```bash\ndocker exec dailyhub npm run db:seed\n```\n\nFrom a clone, `docker compose up -d` pulls the same image; `docker compose up --build` compiles from this tree.\n\nv1 has **no authentication**. Keep it on localhost, a private network, or behind a reverse proxy. Full self-hosting notes are in [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md).\n\n### Development\n\n```bash\nnpm install\nnpm run dev\n```\n\nRuns on port **9999** with SQLite in `./.data/`. Commands, layout, and conventions live in [CLAUDE.md](CLAUDE.md).\n\n## Built with\n\nNext.js 15, TypeScript, SQLite, and Prisma. There is no separate API server — reads go through Server Components, writes through Server Actions.\n\n## Documentation\n\n- [Deployment](docs/DEPLOYMENT.md) — Docker, env vars, self-hosting, troubleshooting\n- [Architecture](docs/ARCHITECTURE.md) — data model and request flow\n- [Design](docs/DESIGN.md) — visual direction and UX patterns\n- [Changelog](CHANGELOG.md) — version history\n\n## License\n\n[MIT](LICENSE) © [Basel Husam](https://baselhusam.com)\n","readmeFilename":"README.md"}