clawd-insights

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #llm #machine-learning #rust #linux #macos #windows #awesome #cli #awesome-list #security #openai

(★ 42)

Your agents do the work — you keep the knowledge. A local-first dashboard (+ desktop pet) that records and replays your Claude Code, Codex CLI and Cursor sessions: timeline, AI session summaries, analytics — all on your machine.

clawd-insights Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# clawd-insights
## Your agents do the work. You keep the knowledge.

**A local-first dashboard that records and replays your AI coding sessions**

> "Hello Clawd, it's time for your weekly report"

[![Local-First](https://img.shields.io/badge/Local--First-8b5cf6)](https://raw.githubusercontent.com/yx0716/clawd-insights/main/)
[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-3178c6)](https://raw.githubusercontent.com/yx0716/clawd-insights/main/LICENSE)
[![Platform](https://img.shields.io/badge/Platform-macOS%20(primary)-111827)](https://raw.githubusercontent.com/yx0716/clawd-insights/main/)
[![Powered by Claude · Codex](https://img.shields.io/badge/Powered_by-Claude%20%C2%B7%20Codex-d97757)](https://raw.githubusercontent.com/yx0716/clawd-insights/main/)
[![Built on Electron](https://img.shields.io/badge/Built_on-Electron-47848f)](https://raw.githubusercontent.com/yx0716/clawd-insights/main/)

<a href="#quick-install">Install</a> ·
 <a href="#features">Features</a> ·
 <a href="#getting-started">Guide</a> ·
 <a href="#how-it-works">How it works</a> ·
 <a href="#faq">FAQ</a> ·
 <a href="README.zh-CN.md">中文版</a>

</div>

<table align="center">
 <tr>
 <td width="50%" align="center" valign="top">
 <img src="assets/screenshot-timeline-1.png" alt="Timeline Dashboard" />
 Timeline view — every session, traced
 </td>
 <td width="50%" align="center" valign="top">
 <img src="assets/screenshot-ai-analysis.png" alt="AI Session Analysis" />
 AI session review — what you tried, what you learned
 </td>
 </tr>
</table>

**Clawd Insights automatically scans the conversations you've already had with Claude Code, Claude Internal, tclaude, Codex CLI, Cursor and other agents, and turns them into a timeline plus AI-generated session summaries.** No more scrolling through endless chat history — it builds the knowledge cards for you.

Every conversation leaves an **imprint**. No idea you tried, no bug you wrestled with, no decision you made together with the Agent is ever wasted — they all come back into view in the **Analytics Dashboard**. Trace back what happened, review how it went, keep what you learned — instead of leaving it buried in a dozen closed terminal tabs.

All data stays on your machine. AI analysis runs through your own local `claude` / `codex` CLI (or an API / Ollama backend you configure). Your conversations never touch a third party.

> Currently focused on macOS. Windows/Linux may work, but they are not the primary supported environments yet. Requires Node.js.

## Quick Install

```bash
git clone https://github.com/yx0716/clawd-insights.git && cd clawd-insights && npm install && npm start
```

A small crab appears on your desktop — on macOS, right-click it to open the **Analytics Dashboard**. For provider setup and analysis workflows, see [Getting Started](#getting-started) below.

## Features

| Capability | What you get |
|---|---|
| **Timeline view** | Visualize every session by date / project / agent / duration — at a glance, see when you worked, on what, and for how long |
| **Local history scan** | Reads `~/.claude/projects/`, `~/.claude-internal/projects/`, `~/.tclaude/projects/`, `~/.codex/sessions/`, `~/.cursor/projects/` directly. No upload, no telemetry |
| **AI session review** | Per-session summary from the *user's* point of view: what you were trying to do, what you walked away with, key topics, time breakdown |
| **Flexible backends** | Local `claude` CLI, local `codex` CLI, or fall back to a configured API provider / Ollama — your choice, your keys. Add any number of **custom OpenAI-compatible endpoints** (Zhipu AI, DeepSeek, OpenRouter…) for cheap session analysis |
| **Batch pre-analysis** | Pre-compute summaries for recent sessions and reuse provider-aware cached results |
| **Cost tracking** | See token usage and cost per analysis run |
| **Quick access** | Open from the tray menu, the right-click menu on the desktop pet, or a global shortcut |

### Usage examples

<table align="center">
 <tr>
 <td width="25%" align="center" valign="top">
 <img src="assets/screenshot-dashboard-menu.gif" alt="Open the dashboard" />
 ① Open right-click → Dashboard
 </td>
 <td width="25%" align="center" valign="top">
 <img src="assets/screen-shot-select-AI-provider.gif" alt="Pick a provider" />
 ② Pick a provider Local CLI / API / Ollama
 </td>
 <td width="25%" align="center" valign="top">
 <img src="assets/screenshot-ai-provider-settings.gif" alt="Tweak settings" />
 ③ Tweak settings gear ⚙ → AI Provider
 </td>
 <td width="25%" align="center" valign="top">
 <img src="assets/screenshot-ai-analysis.gif" alt="Run analysis" />
 ④ Run analysis batch or per-session
 </td>
 </tr>
</table>

## Getting Started

### 1. Install and run

```bash
git clone https://github.com/yx0716/clawd-insights.git && cd clawd-insights && npm install && npm start
```

Once it launches, a small crab (the default theme) appears on your desktop — that's the Clawd pet, and **every entry point to the dashboard goes through it**.

### 2. Open the Analytics Dashboard

There are three ways to open it — pick whichever feels natural:

- **Right-click the desktop pet** → choose **Analytics Dashboard** from the context menu
- **Click the tray icon** (menu bar on macOS) → **Analytics Dashboard**
- **Keyboard shortcut**: macOS `⌘ + Shift + Option + A`

The first time you open it, you'll see your timeline immediately — it just reads the session logs already on your disk. **No setup required for that part.**

### 3. Configure an AI Provider for session summaries

The timeline works out of the box. But to make the dashboard automatically **generate a recap summary for each session**, you need to point it at something that can call a large language model — an **AI Provider** (the analysis backend). There are three options:

| Provider type | What it is | Setup | Best for |
|---|---|---|---|
| **Local CLI** *(recommended)* | Reuses the `claude` (Claude Code) or `codex` CLI you already have installed. Uses your existing subscription, no extra API charges. | **Nothing — auto-detected** | Anyone already using Claude Code or Codex — zero overhead |
| **API key** | An API key from Anthropic, OpenAI, or another provider. Pay-per-token. | Paste your key into the dashboard settings | Users without a local CLI who don't mind a small token cost |
| **Ollama** | A locally-hosted open model server (e.g. Ollama). | Point the dashboard at your Ollama endpoint | Fully offline, never sends data to the cloud |

> **💡 Strong recommendation**: if you already have Claude Code or Codex CLI installed, **do nothing** — the dashboard auto-detects them and reuses your existing subscription quota. Cheapest and easiest path.

If you don't want to configure a provider right now, click **Skip** on the startup screen. You can always set it up later in the settings.

### 4. Where to configure / change the provider later

If you skipped step 3, or you want to switch providers later, you can adjust it via **AI Provider Settings** at any time:

Open the Analytics Dashboard → click the **gear icon ⚙** in the top-right → **AI Provider Settings** dialog appears.

The dialog has two sections:

- **LOCAL CLI DETECTION** — shows whether the dashboard found `claude` and `codex` on your machine. Green dot = found (with version + path); red dot = missing. **If you see green dots, everything is working — proceed to the next step.**
- **API PROVIDER (FALLBACK)** — if no local CLI is installed, you can use an API key for AI session analysis (Claude / OpenAI / Ollama / …) — just paste the key and you're set.
- **CUSTOM ANALYSIS PROVIDERS** — add any number of OpenAI-compatible endpoints (Zhipu AI, DeepSeek, OpenRouter, university APIs, etc.) as dedicated analysis backends. See below.

> **Tip**: if your `claude` or `codex` was installed via **NVM, fnm, or Volta**, auto-detection may miss it. Run `which claude` or `which codex` in your terminal and paste the output into the **Claude binary path** / **Codex binary path** override field.

### Custom Analysis Providers

You can add cheap, dedicated API endpoints specifically for session analysis — keeping your expensive coding models for actual work.

**Why this matters**: your coding sessions use Claude Code or Codex (subscription or pay-per-token). Session *analysis* is a much simpler task — a `glm-4-flash` call costs ~$0.0001 vs ~$0.01 for a Sonnet call. Adding a cheap custom provider lets you analyze hundreds of sessions for pennies.

#### Adding a custom provider

1. Open the Analytics Dashboard → click the **gear icon ⚙** → **AI Provider Settings**
2. Scroll to **Custom Analysis Providers** → click **+ Add Provider**
3. Fill in the form:
   - **Provider Name** — a friendly label (e.g. `Zhipu AI GLM-4-Flash`)
   - **Type** — `OpenAI-Compatible` for most providers; `Claude` for Anthropic-format; `Ollama` for local
   - **API Endpoint** — your provider's base URL (the `/v1/chat/completions` path is appended automatically for OpenAI-compatible)
   - **API Key** — your key (stored locally in your prefs file, never uploaded)
   - **Model** — the model identifier
4. Click **Test Connection** to verify, then **Save**

The provider immediately appears in the **provider pill** dropdown on every session card — click it to switch which backend analyzes that session.

#### Popular cheap providers

| Provider | Type | Endpoint | Recommended model |
|---|---|---|---|
| **Zhipu AI (智谱)** | OpenAI-Compatible | `https://open.bigmodel.cn/api/paas/v4` | `glm-4-flash` |
| **DeepSeek** | OpenAI-Compatible | `https://api.deepseek.com` | `deepseek-chat` |
| **OpenRouter** | OpenAI-Compatible | `https://openrouter.ai/api/v1` | `google/gemini-flash-1.5` |
| **Ollama (local)** | Ollama | `http://localhost:11434` | `qwen2.5:7b` |
| **University API** | OpenAI-Compatible | your institution's endpoint | `gpt-4o-mini` |

### Quick self-check

1. You have used `Claude Code`, `Codex`, or `Cursor Agent` locally, and it is still available now
2. Local session history exists

**Quick check**

- Open Settings and look at `Local CLI Detection`
- Switch to `Week` or `Month` and check whether the timeline shows any sessions

### 5. Start AI session analysis

#### Method A: Batch pre-analysis (auto-prompted on dashboard open)

Every time you open the Analytics Dashboard, if there are unanalyzed sessions, the dashboard **automatically pops up a dialog** — `Pre-analyze Sessions` — letting you analyze a whole time range in one go.

> **Note**: the dashboard's own internal AI summary jobs are automatically excluded from the timeline and session stats. Even if you launch `npm start` from some other directory, those internal analysis runs will not be counted as work sessions.

Available scopes:

- **Today** — every session from today
- **3 Days** — the last 3 days
- **Week** — the last 7 days
- **Custom** — your last N sessions

Pick a scope, hit confirm, and the dashboard runs through them in the background, showing an `Analyzing 1/N`, `2/N`, ... progress bar. **Already-analyzed sessions are auto-skipped** (per-provider cache), so re-clicking never wastes tokens.

> **Best for**: first-time users, monthly retrospectives, catching up on a backlog.

#### Method B: Click a single session (from the timeline or the sessions list)

If you **only want to review one specific session**, no batch needed, just click it:

- **From the timeline** — in Timeline view, click any colored block (each block is a session) and the detail card slides out on the right
- **From the Sessions list** — click any session card in the right-side list

Either way, the dashboard will:

1. Show the **cached summary first** if it exists (sessions previously batch-analyzed are tagged `Analyzed` and open instantly)
2. If not yet analyzed, the click **immediately kicks off a single-session analysis** — the card shows an `Analyzing…` tag, and the result appears in seconds to tens of seconds

> **Best for**: you already know which session you want to revisit, ad-hoc lookups, day-to-day "scrolling through" history.

**In summary:**

- **First time using it** → run **Method A on Week** once, or pick a custom range/count for the sessions you want analyzed. Takes a few minutes and costs more tokens upfront, but every record opens instantly afterwards.
- **Daily use** → after that initial batch, switch to **Method B — pick specific sessions** as needed. Only fresh ones require a manual trigger.
- **Token-sensitive** → use **Method B on demand**. Only analyze the sessions you actually want to read — zero wasted tokens.

> **About cost**: Local CLI (Claude Code / Codex subscription) analysis **uses your existing subscription quota** — typically no extra charges. In API key mode, the dashboard shows **token usage and cost** in the top status bar after each analysis completes, so you always know what you're spending.

## How it works

Clawd runs two independent data paths side by side:

```
Your Agent                              Clawd
  │                                      │
  ├── live events ──→ hook / poll / plugin ──→ 🦀 pet animation
  │                                      │
  └── chat history ──→ local JSONL files ────→ 📊 insights dashboard
```

### Path ①: Live awareness → pet animation

While an agent works (calling tools, waiting for input, erroring out, finishing a task…) it emits events. Clawd captures them through three integration modes and drives the pet accordingly:

| Mode | How it works | Latency | Agents |
|---|---|---|---|
| **Command hook** | Agent fires an event → automatically runs a script → script HTTP-POSTs the event to Clawd's local server (`127.0.0.1:23333`) | Near zero | Claude Code, Claude Internal, tclaude, Copilot CLI, Gemini CLI, Cursor Agent, Kiro CLI, Antigravity CLI, CodeBuddy, Kimi CLI |
| **Log polling** | Clawd scans the agent's JSONL log file every ~1.5 s and detects new entries | ~1.5 s | Codex CLI, Gemini CLI (fallback), Kimi CLI (fallback) |
| **In-process plugin** | Plugin runs inside the agent's own runtime, forwarding events with zero overhead | Zero | opencode, openclaw, Hermes, Pi |

All events map to the same state machine: `idle → thinking → working → happy / error → sleeping`. The pet plays the matching SVG animation. When multiple sessions run simultaneously, it auto-switches to juggling / building / conducting animations.

> **Multi-agent coexistence**: Claude Code, Claude Internal, tclaude, Codex, Copilot, Gemini, Cursor, Kiro, opencode, Antigravity CLI, CodeBuddy, Hermes, Kimi CLI, openclaw, and Pi can all run at the same time. Clawd tracks each session independently and displays the highest-priority state.

### Path ②: Offline analysis → insights dashboard

Every conversation you have with an agent is saved as JSONL on your disk:

| Agent | Local history path |
|---|---|
| Claude Code | `~/.claude/projects/` |
| Claude Internal | `~/.claude-internal/projects/` |
| tclaude | `~/.tclaude/projects/` |
| Codex CLI | `~/.codex/sessions/` |
| Cursor Agent | `~/.cursor/projects/` |

The insights dashboard reads these files directly to generate timelines and AI summaries. **It doesn't go through hooks and doesn't require the pet to be running** — as long as chat history exists on disk, the dashboard works.

> **Note**: the analytics scanner currently covers only the four agents above. Copilot CLI, Gemini CLI, Kiro CLI, and opencode still drive pet animations, but their local histories are not yet wired into the dashboard scanner.

## Desktop pet capabilities (synced from upstream)

Beyond the analytics layer, this fork now tracks the full desktop-pet feature set from [`clawd-on-desk`](https://github.com/rullerzhou-afk/clawd-on-desk):

- **Broader agent support** — pixel-art reactions for **Claude Code, Claude Internal, tclaude, Codex CLI, Copilot CLI, Gemini CLI, Cursor Agent, Kiro CLI, opencode**, plus the newly merged **Antigravity CLI, CodeBuddy, Hermes, Kimi CLI, openclaw, and Pi**.
- **WSL & remote development** *(focus of this sync)* — Codex officially supports **WSL2**, and Clawd integrates through Codex's official hooks (with JSONL polling as a fallback). For an agent running on a remote box or inside WSL's separate Linux home, **Remote SSH** deploys the hooks over an SSH tunnel so the pet reacts to those sessions too. The remote side must use a POSIX shell — **Git Bash or WSL `bash`, not Windows `cmd.exe`**. See [docs/guides/codex-wsl-clarification.md](docs/guides/codex-wsl-clarification.md) and [docs/guides/setup-guide.md](docs/guides/setup-guide.md).
- **GUI settings panel** — a full settings window (agents, themes, shortcuts, Remote SSH, Telegram approval) replaces hand-editing config files.
- **Theming** — swap the crab for alternate characters (e.g. the Cloudling theme) or build your own with `npm run create-theme`.
- **Telegram approval** — approve or deny permission requests remotely from your phone.
- **Doctor diagnostics** — a built-in health check that verifies hook installation and per-agent integration status.
- **Session HUD & Quick Commands** — optional on-screen session-state labels and a quick-command surface.
- **The classics** — permission bubbles, mini mode, click reactions, eye-tracking, sleep sequences, and multi-monitor support all carried over.

Platform notes (Windows terminal focus, macOS focus, known limitations) live under [docs/guides/](docs/guides/).

## FAQ

**Q: Does the dashboard need internet?**
Scanning and the timeline are **fully offline**. Whether AI summaries need internet depends on which provider you pick: Local CLI uses whatever network stack Claude Code / Codex normally use; Ollama is fully offline; API key mode talks to the cloud.

**Q: Are my conversations uploaded anywhere?**
No. Clawd Insights collects zero telemetry. The provider step is *your* CLI or *your* API key calling *the model you chose* directly — no third-party server in the middle.

**Q: I don't have Claude Code or Codex. Can I still use it?**
Yes. You can use the timeline view alone (completely free, no LLM required), or paste an Anthropic / OpenAI API key into AI Provider Settings to enable the cloud path.

## Contributing

Clawd Insights is a community-driven fork. Bug reports, feature ideas, and pull requests are all welcome — open an [issue](https://github.com/yx0716/clawd-insights/issues) to discuss or submit a PR directly.

Credits are split in two: the people who build **this fork** (the analytics layer and everything listed above it), and the **upstream community** behind the desktop pet this fork stands on.

### Contributors

Thanks to everyone who has contributed to this fork:

<table>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/yx0716"><img src="https://github.com/yx0716.png" width="50" style="border-radius:50%" /> yx0716</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/kingsley-wade"><img src="https://github.com/kingsley-wade.png" width="50" style="border-radius:50%" /> kingsley-wade</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/dopawei"><img src="https://github.com/dopawei.png" width="50" style="border-radius:50%" /> dopawei</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/XingLiu1"><img src="https://github.com/XingLiu1.png" width="50" style="border-radius:50%" /> XingLiu1</a></td>
 </tr>
</table>

### Upstream · clawd-on-desk

The desktop pet underneath — animations, permission bubbles, multi-agent tracking, themes, the lot — is the work of the [`clawd-on-desk`](https://github.com/rullerzhou-afk/clawd-on-desk) community. The roll below is carried over from the upstream README (snapshot: July 2026); the canonical, always-current list lives [there](https://github.com/rullerzhou-afk/clawd-on-desk#contributing).

#### Maintainers

<table>
 <tr>
 <td align="center" valign="top" width="140"><a href="https://github.com/rullerzhou-afk"><img src="https://github.com/rullerzhou-afk.png" width="72" style="border-radius:50%" /> @rullerzhou-afk 鹿鹿 · creator</a></td>
 <td align="center" valign="top" width="140"><a href="https://github.com/YOIMIYA66"><img src="https://github.com/YOIMIYA66.png" width="72" style="border-radius:50%" /> @YOIMIYA66 maintainer</a></td>
 <td align="center" valign="top" width="140"><a href="https://github.com/Bynlk"><img src="https://github.com/Bynlk.png" width="72" style="border-radius:50%" /> @Bynlk core contributor · Mobile / PWA</a></td>
 </tr>
</table>

#### Contributors

Thanks to everyone who has helped make Clawd better:

<table>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/PixelCookie-zyf"><img src="https://github.com/PixelCookie-zyf.png" width="50" style="border-radius:50%" /> PixelCookie-zyf</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/yujiachen-y"><img src="https://github.com/yujiachen-y.png" width="50" style="border-radius:50%" /> yujiachen-y</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/AooooooZzzz"><img src="https://github.com/AooooooZzzz.png" width="50" style="border-radius:50%" /> AooooooZzzz</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/purefkh"><img src="https://github.com/purefkh.png" width="50" style="border-radius:50%" /> purefkh</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Tobeabellwether"><img src="https://github.com/Tobeabellwether.png" width="50" style="border-radius:50%" /> Tobeabellwether</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Jasonhonghh"><img src="https://github.com/Jasonhonghh.png" width="50" style="border-radius:50%" /> Jasonhonghh</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/crashchen"><img src="https://github.com/crashchen.png" width="50" style="border-radius:50%" /> crashchen</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/hongbigtou"><img src="https://github.com/hongbigtou.png" width="50" style="border-radius:50%" /> hongbigtou</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/InTimmyDate"><img src="https://github.com/InTimmyDate.png" width="50" style="border-radius:50%" /> InTimmyDate</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/NeizhiTouhu"><img src="https://github.com/NeizhiTouhu.png" width="50" style="border-radius:50%" /> NeizhiTouhu</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/xu3stones-cmd"><img src="https://github.com/xu3stones-cmd.png" width="50" style="border-radius:50%" /> xu3stones-cmd</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/androidZzT"><img src="https://github.com/androidZzT.png" width="50" style="border-radius:50%" /> androidZzT</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Ye-0413"><img src="https://github.com/Ye-0413.png" width="50" style="border-radius:50%" /> Ye-0413</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/WanfengzzZ"><img src="https://github.com/WanfengzzZ.png" width="50" style="border-radius:50%" /> WanfengzzZ</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/TaoXieSZ"><img src="https://github.com/TaoXieSZ.png" width="50" style="border-radius:50%" /> TaoXieSZ</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/ssly"><img src="https://github.com/ssly.png" width="50" style="border-radius:50%" /> ssly</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/stickycandy"><img src="https://github.com/stickycandy.png" width="50" style="border-radius:50%" /> stickycandy</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Rladmsrl"><img src="https://github.com/Rladmsrl.png" width="50" style="border-radius:50%" /> Rladmsrl</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/YOIMIYA66"><img src="https://github.com/YOIMIYA66.png" width="50" style="border-radius:50%" /> YOIMIYA66</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Kevin7Qi"><img src="https://github.com/Kevin7Qi.png" width="50" style="border-radius:50%" /> Kevin7Qi</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/sefuzhou770801-hub"><img src="https://github.com/sefuzhou770801-hub.png" width="50" style="border-radius:50%" /> sefuzhou770801-hub</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/Tonic-Jin"><img src="https://github.com/Tonic-Jin.png" width="50" style="border-radius:50%" /> Tonic-Jin</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/seoki180"><img src="https://github.com/seoki180.png" width="50" style="border-radius:50%" /> seoki180</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/sophie-haynes"><img src="https://github.com/sophie-haynes.png" width="50" style="border-radius:50%" /> sophie-haynes</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/PeterShanxin"><img src="https://github.com/PeterShanxin.png" width="50" style="border-radius:50%" /> PeterShanxin</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/CHIANGANGSTER"><img src="https://github.com/CHIANGANGSTER.png" width="50" style="border-radius:50%" /> CHIANGANGSTER</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/JaeHyeon-KAIST"><img src="https://github.com/JaeHyeon-KAIST.png" width="50" style="border-radius:50%" /> JaeHyeon-KAIST</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/hhhzxyhhh"><img src="https://github.com/hhhzxyhhh.png" width="50" style="border-radius:50%" /> hhhzxyhhh</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/TVpoet"><img src="https://github.com/TVpoet.png" width="50" style="border-radius:50%" /> TVpoet</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/zeus6768"><img src="https://github.com/zeus6768.png" width="50" style="border-radius:50%" /> zeus6768</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/anhtrinh919"><img src="https://github.com/anhtrinh919.png" width="50" style="border-radius:50%" /> anhtrinh919</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/tomaioo"><img src="https://github.com/tomaioo.png" width="50" style="border-radius:50%" /> tomaioo</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/v-avuso"><img src="https://github.com/v-avuso.png" width="50" style="border-radius:50%" /> v-avuso</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/livlign"><img src="https://github.com/livlign.png" width="50" style="border-radius:50%" /> livlign</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/tongguang2"><img src="https://github.com/tongguang2.png" width="50" style="border-radius:50%" /> tongguang2</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/Ziy1-Tan"><img src="https://github.com/Ziy1-Tan.png" width="50" style="border-radius:50%" /> Ziy1-Tan</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/tatsuyanakanogaroinc"><img src="https://github.com/tatsuyanakanogaroinc.png" width="50" style="border-radius:50%" /> tatsuyanakanogaroinc</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/yeonhub"><img src="https://github.com/yeonhub.png" width="50" style="border-radius:50%" /> yeonhub</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/joshua-wu"><img src="https://github.com/joshua-wu.png" width="50" style="border-radius:50%" /> joshua-wu</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/nmsn"><img src="https://github.com/nmsn.png" width="50" style="border-radius:50%" /> nmsn</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/sunnysonx"><img src="https://github.com/sunnysonx.png" width="50" style="border-radius:50%" /> sunnysonx</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/YuChenYunn"><img src="https://github.com/YuChenYunn.png" width="50" style="border-radius:50%" /> YuChenYunn</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/jhseo-b"><img src="https://github.com/jhseo-b.png" width="50" style="border-radius:50%" /> jhseo-b</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Hwasowl"><img src="https://github.com/Hwasowl.png" width="50" style="border-radius:50%" /> Hwasowl</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/XiangZheng2002"><img src="https://github.com/XiangZheng2002.png" width="50" style="border-radius:50%" /> XiangZheng2002</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/keiyo118"><img src="https://github.com/keiyo118.png" width="50" style="border-radius:50%" /> keiyo118</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/pan93412"><img src="https://github.com/pan93412.png" width="50" style="border-radius:50%" /> pan93412</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/taehwanis"><img src="https://github.com/taehwanis.png" width="50" style="border-radius:50%" /> taehwanis</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/linnin233"><img src="https://github.com/linnin233.png" width="50" style="border-radius:50%" /> linnin233</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/xiyouMc"><img src="https://github.com/xiyouMc.png" width="50" style="border-radius:50%" /> xiyouMc</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Bynlk"><img src="https://github.com/Bynlk.png" width="50" style="border-radius:50%" /> Bynlk</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/zxypro1"><img src="https://github.com/zxypro1.png" width="50" style="border-radius:50%" /> zxypro1</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/NeroAyase"><img src="https://github.com/NeroAyase.png" width="50" style="border-radius:50%" /> NeroAyase</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/divergentD"><img src="https://github.com/divergentD.png" width="50" style="border-radius:50%" /> divergentD</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Ne9roni"><img src="https://github.com/Ne9roni.png" width="50" style="border-radius:50%" /> Ne9roni</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/QingXB"><img src="https://github.com/QingXB.png" width="50" style="border-radius:50%" /> QingXB</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/29206394"><img src="https://github.com/29206394.png" width="50" style="border-radius:50%" /> 藤知</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Tsdsj"><img src="https://github.com/Tsdsj.png" width="50" style="border-radius:50%" /> Tsdsj</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/godlockin"><img src="https://github.com/godlockin.png" width="50" style="border-radius:50%" /> godlockin</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/sLingli"><img src="https://github.com/sLingli.png" width="50" style="border-radius:50%" /> sLingli</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/ustin-star"><img src="https://github.com/ustin-star.png" width="50" style="border-radius:50%" /> ustin-star</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/cod3hulk"><img src="https://github.com/cod3hulk.png" width="50" style="border-radius:50%" /> cod3hulk</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/lxgxhsy"><img src="https://github.com/lxgxhsy.png" width="50" style="border-radius:50%" /> lxgxhsy</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/rebootcrab-blip"><img src="https://github.com/rebootcrab-blip.png" width="50" style="border-radius:50%" /> rebootcrab-blip</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/zhaoxv210"><img src="https://github.com/zhaoxv210.png" width="50" style="border-radius:50%" /> zhaoxv210</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/serenNan"><img src="https://github.com/serenNan.png" width="50" style="border-radius:50%" /> serenNan</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/IatomicreactorI"><img src="https://github.com/IatomicreactorI.png" width="50" style="border-radius:50%" /> IatomicreactorI</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/quantai1314"><img src="https://github.com/quantai1314.png" width="50" style="border-radius:50%" /> quantai1314</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Git-creat7"><img src="https://github.com/Git-creat7.png" width="50" style="border-radius:50%" /> Git-creat7</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/undownding"><img src="https://github.com/undownding.png" width="50" style="border-radius:50%" /> undownding</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/chrono-meta"><img src="https://github.com/chrono-meta.png" width="50" style="border-radius:50%" /> chrono-meta</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/Yike-Ye"><img src="https://github.com/Yike-Ye.png" width="50" style="border-radius:50%" /> Yike-Ye</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/xiaoshidefeng"><img src="https://github.com/xiaoshidefeng.png" width="50" style="border-radius:50%" /> xiaoshidefeng</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/yanguibao1997"><img src="https://github.com/yanguibao1997.png" width="50" style="border-radius:50%" /> yanguibao1997</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/JasonZH6600"><img src="https://github.com/JasonZH6600.png" width="50" style="border-radius:50%" /> JasonZH6600</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/V1staz"><img src="https://github.com/V1staz.png" width="50" style="border-radius:50%" /> V1staz</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/royhuang91"><img src="https://github.com/royhuang91.png" width="50" style="border-radius:50%" /> royhuang91</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="110"><a href="https://github.com/Schlaflied"><img src="https://github.com/Schlaflied.png" width="50" style="border-radius:50%" /> Schlaflied</a></td>
 <td align="center" valign="top" width="110"><a href="https://github.com/KaiC5504"><img src="https://github.com/KaiC5504.png" width="50" style="border-radius:50%" /> KaiC5504</a></td>
 </tr>
</table>

## Lineage & Credits

Clawd Insights is the **analytics layer** built on top of [`rullerzhou-afk/clawd-on-desk`](https://github.com/rullerzhou-afk/clawd-on-desk), the lovely desktop pet that turns your coding agent's state into pixel art. Everything that makes the pet delightful — animations, permission bubbles, multi-agent state tracking, mini mode, the lot — is still here, untouched. What this fork adds is one extra question: **what if every conversation you've ever had with the agent was searchable, summarised, and waiting for you on a single dashboard?**

That dashboard is the new piece. It scans your local history (Claude Code, Claude Internal, tclaude, Codex CLI, Cursor Agent today; more agents on the way), draws a timeline, and lets your own LLM write per-session summaries — all without sending a byte to a third party.

Multi-agent state tracking carried over from upstream — and this repo now stays in sync with the full upstream codebase (WSL & Remote SSH support, the expanded agent roster, the GUI settings panel, theming, Telegram approval, doctor diagnostics, and more). For the desktop pet's own feature list, see [Desktop pet capabilities](#desktop-pet-capabilities-synced-from-upstream) above.

Huge thanks to [@rullerzhou-afk](https://github.com/rullerzhou-afk) and every contributor who shaped the original Clawd — this project wouldn't exist without that foundation. The full credit roll, fork and upstream side by side, is in [Contributing](#contributing) above.

## License

Source code: [GNU AGPL-3.0-only](LICENSE) — adopted from upstream `clawd-on-desk`, whose code this repo now incorporates. See also [NOTICE.md](NOTICE.md) for third-party materials.

- **Clawd** character is the property of [Anthropic](https://www.anthropic.com). Unofficial fan project, not affiliated with Anthropic.
- **Calico cat (三花猫)** artwork by 鹿鹿 ([@rullerzhou-afk](https://github.com/rullerzhou-afk)). All rights reserved.
- **Third-party contributions**: copyright retained by respective artists.

clawd-insights

clawd-insights Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

clawd-insights

clawd-insights Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README