dailycity

Installs the DailyCity habit-dashboard skill for Claude Code and/or Codex.

Requirements

• Node.js >= 18 (to run this installer)
• python3 on PATH (to run the skill itself — the installer warns, but does not fail, if it's missing)
• Claude Code and/or Codex CLI, so the installed skill is discoverable

Usage

npx dailycity

This installs the dailycity skill into ~/.claude/skills/dailycity and ~/.codex/skills/dailycity, and creates a self-contained data directory at ~/.dailycity (the built dashboard site plus your habit data — nothing is written outside these two locations). Re-running is safe and upgrades the installed skill and site in place without touching your existing habit data.

Once installed, open Claude Code or Codex and say "dailycity" (or "daily city", "log my day", "open the habit website") to start using it. Every install starts completely blank — no name, no habits baked in; the skill's onboarding flow sets those up on first use.

Commands

Once the skill is running in chat, it dispatches to these:

• website — serve and open the dashboard
• overview — print your stats (habits tracked, today's progress, streaks, 7-day completion, focus time) plus a link without opening the browser
• analytics — print Analytics-page weekly completion, score delta, most-active day, streak, focus-goal, and daily-trend stats plus a link without opening the browser
• habits — list or add habits
• log — log today's (or a past day's) habit completions, e.g. "I did French today"
• share — open the Share page for exporting/posting your stats

Flags

• --claude / --codex — install into only one target (default: both)
• --root <dir> — use a different data directory instead of ~/.dailycity
• npx dailycity uninstall — remove the skill from both targets (keeps ~/.dailycity)
• npx dailycity uninstall --purge — also delete ~/.dailycity and your habit data