agentfit 0.1.0

package/.claude/settings.local.json

@@ -0,0 +1,26 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python3 -m json.tool)",
+      "Bash(python3:*)",
+      "Bash(head -5 /Users/harrywang/sandbox/bizpub-cc/logs/*.jsonl)",
+      "Bash(wc -l /Users/harrywang/sandbox/bizpub-cc/logs/*.jsonl)",
+      "Read(//private/tmp/**)",
+      "Bash(rm -rf agentfit-scaffold)",
+      "Bash(npx create-next-app@latest agentfit-scaffold --typescript --tailwind --eslint --app --src-dir --no-import-alias --use-npm --no-turbopack)",
+      "Bash(curl -s https://api.github.com/repos/ryoppippi/ccusage/contents)",
+      "Bash(curl -s \"https://api.github.com/search/code?q=repo:ryoppippi/ccusage+filename:model\")",
+      "Bash(curl:*)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(lsof -ti:3000,3001)",
+      "Bash(npm install:*)",
+      "Bash(npx prisma:*)",
+      "Bash(ls -la /Users/harrywang/sandbox/agentfit/*.md)",
+      "WebSearch",
+      "WebFetch(domain:betelgeuse.work)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:ui.shadcn.com)",
+      "Bash(npx shadcn@latest init -p blue --force)"
+    ]
+  }
+}

package/.prettierignore

@@ -0,0 +1,7 @@
+dist/
+node_modules/
+.next/
+.turbo/
+coverage/
+pnpm-lock.yaml
+.pnpm-store/

package/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "endOfLine": "lf",
+  "semi": false,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 80,
+  "plugins": ["prettier-plugin-tailwindcss"],
+  "tailwindStylesheet": "app/globals.css",
+  "tailwindFunctions": ["cn", "cva"]
+}

package/CONTRIBUTING.md

@@ -0,0 +1,209 @@
+# Contributing a Community Plugin
+
+AgentFit has a plugin system that lets anyone contribute new analysis views. Your plugin appears in the **Community** sidebar section and receives the same usage data as built-in pages.
+
+## Quick Start
+
+```bash
+# 1. Fork & clone
+git clone https://github.com/<you>/agentfit && cd agentfit
+npm install
+
+# 2. Scaffold your plugin
+mkdir -p plugins/my-analysis
+
+# 3. Create the two required files (see below)
+# 4. Register it in plugins/index.ts
+# 5. Run dev server & tests
+npm run dev
+npm test
+```
+
+## Plugin Structure
+
+Every plugin lives in its own folder under `plugins/` and has exactly **two files** plus a test:
+
+```
+plugins/
+  my-analysis/
+    manifest.ts          # metadata (name, slug, icon, etc.)
+    component.tsx        # React component that renders the analysis
+    component.test.tsx   # tests (required for PR acceptance)
+```
+
+### manifest.ts
+
+```ts
+import type { PluginManifest } from '@/lib/plugins'
+
+const manifest: PluginManifest = {
+  slug: 'my-analysis',          // URL-safe, lowercase, hyphens only
+  name: 'My Analysis',          // shown in sidebar
+  description: 'One-line summary of what this shows',
+  author: 'your-github-handle',
+  icon: 'ChartArea',            // any lucide-react icon name
+  version: '1.0.0',
+  tags: ['cost', 'productivity'],  // optional, for discoverability
+}
+
+export default manifest
+```
+
+**Slug rules:** lowercase letters, numbers, hyphens only (e.g. `my-analysis`). Must be unique across all plugins.
+
+### component.tsx
+
+```tsx
+'use client'
+
+import { useMemo } from 'react'
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
+import type { PluginProps } from '@/lib/plugins'
+
+export default function MyAnalysis({ data }: PluginProps) {
+  const stats = useMemo(() => {
+    // Compute your analysis from data.sessions, data.daily, etc.
+    return { total: data.sessions.length }
+  }, [data])
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle>My Analysis</CardTitle>
+      </CardHeader>
+      <CardContent>
+        <p>Found {stats.total} sessions</p>
+      </CardContent>
+    </Card>
+  )
+}
+```
+
+### Registration
+
+Open `plugins/index.ts` and add your import + registration call:
+
+```ts
+// ─── Community plugins ──────────────────────────────────────────────
+import myAnalysisManifest from './my-analysis/manifest'
+import MyAnalysis from './my-analysis/component'
+registerPlugin(myAnalysisManifest, MyAnalysis)
+```
+
+That's it. Your plugin now appears in the sidebar at `/community/my-analysis`.
+
+## Data Available to Plugins
+
+Your component receives `PluginProps`:
+
+```ts
+interface PluginProps {
+  data: UsageData
+}
+```
+
+`UsageData` contains:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `overview` | `OverviewStats` | Aggregated metrics (totals for sessions, tokens, cost, etc.) |
+| `sessions` | `SessionSummary[]` | Every session with tokens, cost, duration, tool calls |
+| `projects` | `ProjectSummary[]` | Per-project aggregations |
+| `daily` | `DailyUsage[]` | Per-day aggregations |
+| `toolUsage` | `Record<string, number>` | Tool invocation counts |
+
+All data is already filtered by the user's selected time range and agent type. You don't need to filter again.
+
+See `lib/parse-logs.ts` for the full type definitions.
+
+## UI Guidelines
+
+- Use **shadcn UI** components from `components/ui/` (Card, Badge, Table, etc.)
+- Use **Recharts** (already installed) for charts, wrapped in `ChartContainer`
+- Use `lib/format.ts` helpers: `formatCost()`, `formatTokens()`, `formatDuration()`
+- Use the existing CSS chart color variables: `--chart-1` through `--chart-10`
+- Mark your component as `'use client'` at the top
+- Wrap computed values in `useMemo` for performance
+
+## Writing Tests
+
+Every plugin must include tests. Use the provided test helpers:
+
+```tsx
+// plugins/my-analysis/component.test.tsx
+import { describe, it, expect } from 'vitest'
+import { screen } from '@testing-library/react'
+import { renderPlugin } from '@/tests/plugin-helpers'
+import { validateManifest } from '@/lib/plugins'
+import MyAnalysis from './component'
+import manifest from './manifest'
+
+describe('my-analysis plugin', () => {
+  it('manifest passes validation', () => {
+    expect(validateManifest(manifest)).toEqual([])
+  })
+
+  it('renders without crashing', () => {
+    const { container } = renderPlugin(MyAnalysis)
+    expect(container).toBeTruthy()
+  })
+
+  it('shows expected content', () => {
+    renderPlugin(MyAnalysis)
+    expect(screen.getByText('My Analysis')).toBeInTheDocument()
+  })
+
+  it('handles empty data', () => {
+    renderPlugin(MyAnalysis, { sessions: [], daily: [], projects: [] })
+    // Should not crash — show an empty state instead
+  })
+})
+```
+
+### Test utilities
+
+| Helper | Import | Description |
+|--------|--------|-------------|
+| `renderPlugin(Component, dataOverrides?)` | `@/tests/plugin-helpers` | Renders your plugin with mock `UsageData` |
+| `createMockData(overrides?)` | `@/tests/fixtures` | Creates a realistic `UsageData` object |
+| `createMockSession(overrides?)` | `@/tests/fixtures` | Creates a single `SessionSummary` |
+| `createMockDaily(overrides?)` | `@/tests/fixtures` | Creates a single `DailyUsage` |
+| `validateManifest(manifest)` | `@/lib/plugins` | Returns array of validation errors (empty = valid) |
+
+### Running tests
+
+```bash
+npm test                 # run all tests once
+npm run test:watch       # watch mode during development
+```
+
+## PR Checklist
+
+Before submitting your pull request:
+
+- [ ] Plugin folder is in `plugins/<your-slug>/`
+- [ ] `manifest.ts` passes `validateManifest()` with zero errors
+- [ ] `component.tsx` exports a default React component accepting `PluginProps`
+- [ ] Plugin is registered in `plugins/index.ts`
+- [ ] Tests exist in `component.test.tsx` and all pass (`npm test`)
+- [ ] Component handles empty data gracefully (no crashes)
+- [ ] No new dependencies added (use existing recharts, shadcn, lucide-react)
+- [ ] `npm run typecheck` passes
+- [ ] `npm run lint` passes
+
+## Advanced: Custom Data Sources
+
+If your plugin fetches its own data (e.g., from a custom API route), set `customDataSource: true` in your manifest. This hides the time-range filter when your plugin is active.
+
+```ts
+const manifest: PluginManifest = {
+  // ...
+  customDataSource: true,
+}
+```
+
+You can still use the `data` prop as a fallback, but you're free to `fetch()` additional data in a `useEffect`.
+
+## Example Plugin
+
+See `plugins/cost-heatmap/` for a complete working example with manifest, component, and tests.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harry Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# AgentFit
+
+Fitness tracker dashboard for AI coding agents. Reads your local Claude Code and Codex conversation logs, syncs them into a SQLite database, and presents rich usage analytics — cost, tokens, tool usage, productivity patterns, and more.
+
+## Install
+
+### Option 1: One-liner (recommended)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/harrywang/agentfit/main/setup.sh | bash
+```
+
+Then start the dashboard:
+
+```bash
+cd agentfit && npm start
+```
+
+### Option 2: npx
+
+```bash
+npx agentfit
+```
+
+This handles first-run setup (database creation, build) automatically.
+
+### Option 3: Manual
+
+```bash
+git clone https://github.com/harrywang/agentfit.git
+cd agentfit
+npm install
+echo 'DATABASE_URL="file:./dev.db"' > .env
+npx prisma migrate deploy
+npm run build
+npm start
+```
+
+Open [http://localhost:3000](http://localhost:3000). The app auto-syncs your `~/.claude/projects/` logs on first load.
+
+**Requirements:** Node.js 20+
+
+## Features
+
+- **Dashboard** — overview stats (cost, tokens, sessions, projects, messages, tool calls, duration)
+- **Agent Coach** — fitness score, achievements, improvement areas, and tips
+- **Daily Usage** — daily cost and activity charts
+- **Token Breakdown** — pie chart + stacked area chart of token types
+- **Tool Usage** — top 20 tools by invocation count
+- **Projects** — per-project breakdown with top tools and sessions
+- **Personality Fit** — MBTI-style behavioral analysis with task fit scores
+- **Command Usage** — slash command pattern tracking
+- **Images** — screenshot analysis across sessions
+- **Community Plugins** — extensible analysis views contributed by the community
+
+## Data
+
+- Session metrics stored in local SQLite (`dev.db`) via Prisma
+- Images extracted from conversation logs to `data/images/`
+- Pricing fetched from [LiteLLM](https://github.com/BerriAI/litellm) model pricing database
+- Incremental sync — only new sessions are imported on each sync
+- Supports Claude Code, Codex, or combined views
+
+## Development
+
+```bash
+npm run dev          # Start dev server (Turbopack)
+npm run build        # Production build
+npm run lint         # ESLint
+npm run format       # Prettier
+npm run typecheck    # TypeScript check
+npm test             # Run tests
+npm run test:watch   # Tests in watch mode
+```
+
+### Database
+
+```bash
+npx prisma migrate dev --name <name>   # Create/apply migration
+npx prisma generate                    # Regenerate Prisma client
+```
+
+## Community Plugins
+
+AgentFit has a plugin system for community-contributed analysis views. Plugins appear in the **Community** section of the sidebar.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide on creating your own plugin.
+
+**Quick version:**
+
+1. Create `plugins/<your-slug>/manifest.ts` and `component.tsx`
+2. Register in `plugins/index.ts`
+3. Add tests in `component.test.tsx`
+4. Submit a PR
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` or `AGENTFIT_PORT` | `3000` | Server port |
+| `DATABASE_URL` | `file:./dev.db` | SQLite database path |
+
+## Credits
+
+- Logo: [Robot SVG](https://www.svgrepo.com/svg/486361/robot) from SVG Repo (CC0 License)
+
+## License
+
+[MIT](LICENSE)

package/app/(dashboard)/coach/page.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { AgentCoach } from '@/components/agent-coach'
+
+export default function CoachPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return <AgentCoach data={data} />
+}

package/app/(dashboard)/commands/page.tsx

@@ -0,0 +1,7 @@
+'use client'
+
+import { CommandUsage } from '@/components/command-usage'
+
+export default function CommandsPage() {
+  return <CommandUsage />
+}

package/app/(dashboard)/community/[slug]/page.tsx

@@ -0,0 +1,23 @@
+'use client'
+
+import { use } from 'react'
+import { notFound } from 'next/navigation'
+import { useData } from '@/components/data-provider'
+import { getPlugin } from '@/lib/plugins'
+import '@/plugins' // ensure plugins are registered
+
+export default function CommunityPluginPage({
+  params,
+}: {
+  params: Promise<{ slug: string }>
+}) {
+  const { slug } = use(params)
+  const { data } = useData()
+  const plugin = getPlugin(slug)
+
+  if (!plugin) notFound()
+  if (!data) return null
+
+  const Component = plugin.component
+  return <Component data={data} />
+}

package/app/(dashboard)/community/page.tsx

@@ -0,0 +1,71 @@
+'use client'
+
+import Link from 'next/link'
+import { Card, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Badge } from '@/components/ui/badge'
+import { getPlugins } from '@/lib/plugins'
+import { resolveLucideIcon } from '@/lib/resolve-icon'
+import '@/plugins'
+
+export default function CommunityPage() {
+  const plugins = getPlugins()
+
+  return (
+    <div className="space-y-6">
+      <div>
+        <p className="text-sm text-muted-foreground">
+          Community-contributed analysis views. Click a card to explore.
+        </p>
+      </div>
+
+      {plugins.length === 0 ? (
+        <Card>
+          <CardHeader>
+            <CardTitle className="text-base">No community plugins installed</CardTitle>
+            <CardDescription>
+              See CONTRIBUTING.md to learn how to create and share your own analysis plugin.
+            </CardDescription>
+          </CardHeader>
+        </Card>
+      ) : (
+        <div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3">
+          {plugins.map((plugin) => {
+            const Icon = resolveLucideIcon(plugin.manifest.icon)
+            return (
+              <Link
+                key={plugin.manifest.slug}
+                href={`/community/${plugin.manifest.slug}`}
+                className="group"
+              >
+                <Card className="h-full transition-colors group-hover:border-primary/50 group-hover:bg-muted/50">
+                  <CardHeader>
+                    <div className="flex items-start justify-between">
+                      <div className="flex h-10 w-10 items-center justify-center rounded-lg bg-primary/10 text-primary">
+                        <Icon className="h-5 w-5" />
+                      </div>
+                      <Badge variant="secondary" className="text-[10px]">
+                        v{plugin.manifest.version}
+                      </Badge>
+                    </div>
+                    <CardTitle className="text-base">{plugin.manifest.name}</CardTitle>
+                    <CardDescription>{plugin.manifest.description}</CardDescription>
+                    <div className="flex items-center gap-2 pt-1">
+                      <span className="text-xs text-muted-foreground">
+                        by {plugin.manifest.author}
+                      </span>
+                      {plugin.manifest.tags?.map((tag) => (
+                        <Badge key={tag} variant="outline" className="text-[10px]">
+                          {tag}
+                        </Badge>
+                      ))}
+                    </div>
+                  </CardHeader>
+                </Card>
+              </Link>
+            )
+          })}
+        </div>
+      )}
+    </div>
+  )
+}

package/app/(dashboard)/daily/page.tsx

@@ -0,0 +1,19 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { DailyChart } from '@/components/daily-chart'
+import { DailyTable } from '@/components/daily-table'
+
+export default function DailyPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return (
+    <>
+      <div className="grid gap-4 lg:grid-cols-3">
+        <DailyChart daily={data.daily} />
+      </div>
+      <DailyTable daily={data.daily} sessions={data.sessions} />
+    </>
+  )
+}

package/app/(dashboard)/images/page.tsx

@@ -0,0 +1,5 @@
+import { ScreenshotsAnalysis } from '@/components/screenshots-analysis'
+
+export default function ImagesPage() {
+  return <ScreenshotsAnalysis />
+}

package/app/(dashboard)/layout.tsx

@@ -0,0 +1,12 @@
+'use client'
+
+import { DataProvider } from '@/components/data-provider'
+import { DashboardShell } from '@/components/dashboard-shell'
+
+export default function DashboardLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <DataProvider>
+      <DashboardShell>{children}</DashboardShell>
+    </DataProvider>
+  )
+}

package/app/(dashboard)/page.tsx

@@ -0,0 +1,23 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { FitnessScore } from '@/components/fitness-score'
+import { OverviewCards } from '@/components/overview-cards'
+import { DailyChart } from '@/components/daily-chart'
+import { ToolUsageChart } from '@/components/tool-usage-chart'
+
+export default function DashboardPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return (
+    <>
+      <FitnessScore data={data} />
+      <OverviewCards overview={data.overview} sessions={data.sessions} />
+      <div className="grid gap-4 lg:grid-cols-3">
+        <DailyChart daily={data.daily} />
+      </div>
+      <ToolUsageChart toolUsage={data.toolUsage} />
+    </>
+  )
+}

package/app/(dashboard)/personality/page.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { PersonalityFit } from '@/components/personality-fit'
+
+export default function PersonalityPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return <PersonalityFit data={data} />
+}

package/app/(dashboard)/projects/page.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { ProjectsTable } from '@/components/projects-table'
+
+export default function ProjectsPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return <ProjectsTable projects={data.projects} />
+}

package/app/(dashboard)/sessions/page.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { SessionsTable } from '@/components/sessions-table'
+
+export default function SessionsPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return <SessionsTable sessions={data.sessions} />
+}

package/app/(dashboard)/tokens/page.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { TokenBreakdown } from '@/components/token-breakdown'
+
+export default function TokensPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return <TokenBreakdown daily={data.daily} overview={data.overview} />
+}

package/app/(dashboard)/tools/page.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import { useData } from '@/components/data-provider'
+import { ToolUsageChart } from '@/components/tool-usage-chart'
+
+export default function ToolsPage() {
+  const { data } = useData()
+  if (!data) return null
+
+  return <ToolUsageChart toolUsage={data.toolUsage} />
+}

package/app/api/check/route.ts

@@ -0,0 +1,13 @@
+import { NextResponse } from 'next/server'
+import { checkForNewSessions } from '@/lib/sync'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET() {
+  try {
+    const newSessions = await checkForNewSessions()
+    return NextResponse.json({ newSessions })
+  } catch (error) {
+    return NextResponse.json({ newSessions: 0, error: (error as Error).message }, { status: 500 })
+  }
+}

package/app/api/commands/route.ts

@@ -0,0 +1,16 @@
+import { NextResponse } from 'next/server'
+import { analyzeCommands } from '@/lib/commands'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET() {
+  try {
+    const analysis = analyzeCommands()
+    return NextResponse.json(analysis)
+  } catch (error) {
+    return NextResponse.json(
+      { error: (error as Error).message },
+      { status: 500 }
+    )
+  }
+}