Skip to main content
Glama
README.md
# DevRecall

**Your developer activity, aggregated on-device.** No cloud sync. No telemetry.
Your data never leaves your machine.

DevRecall pulls from Git, Slack, Google Calendar, Jira, Linear, Confluence,
GitHub/GitLab/Bitbucket, Notion, and your Claude Code sessions; stores it in a
local SQLite database; and turns it into standups, weekly reports, brag docs,
and a chat that actually knows what you worked on.

Also ships an [MCP server](https://docs.devrecall.dev/integrations/mcp/) —
any MCP-compatible coding tool (Claude Code, Cursor, Codex, Continue, Zed)
can spawn it as a stdio subprocess and gain memory of everything you've
shipped. `/devrecall:recall what auth bug did I fix in February` returns
cited commits, PRs, and tickets inline.

<table>
  <tr>
    <td align="center" width="33%">
      <a href=".github/assets/chat.jpg"><img src=".github/assets/chat.jpg" alt="DevRecall desktop app — chat over your local work history"></a><br>
      <sub>Desktop app — the same memory, native UI</sub>
    </td>
    <td align="center" width="33%">
      <a href=".github/assets/standup.gif"><img src=".github/assets/standup.gif" alt="devrecall standup — syncs your sources and writes the standup for you"></a><br>
      <sub><code>devrecall standup</code> — the day's report, written for you</sub>
    </td>
    <td align="center" width="33%">
      <a href=".github/assets/recall.gif"><img src=".github/assets/recall.gif" alt="devrecall chat — agentic recall over your work history, with cited commits and PRs"></a><br>
      <sub><code>devrecall chat</code> — recall with cited commits &amp; PRs</sub>
    </td>
  </tr>
</table>

📚 **[docs.devrecall.dev](https://docs.devrecall.dev)** — install, configure, integrations, CLI reference.

## Why

- **Local-first.** SQLite on your laptop. Tokens in `~/.devrecall/tokens/` (`0600`). The Cloudflare Worker relay is a pass-through for OAuth callbacks only — it never sees your data.
- **LLM-optional.** Bundled embeddings run offline (ONNX + `all-MiniLM-L6-v2`). Use local Ollama for chat, or bring your own OpenAI/Anthropic key.
- **Open source.** MIT-licensed. Audit it, fork it, build it from source.

## Sources

| Source            | What gets collected                            |
| ----------------- | ---------------------------------------------- |
| Git (local)       | Commits, branch activity, files changed        |
| GitHub / GitLab / Bitbucket | PRs/MRs, reviews, issues, comments   |
| Slack             | Your messages, threads you participated in     |
| Google Calendar   | Meetings attended, organized, declined         |
| Jira / Linear     | Issue transitions, comments, sprint membership |
| Confluence        | Pages, blogposts, and comments you authored    |
| Notion            | Pages you created or edited                    |
| Claude Code       | Coding-agent sessions, linked to repo & branch |

## Install

**macOS** — desktop app + CLI:

```bash
brew install --cask pavelpilyak/devrecall/devrecall
```

Installs `DevRecall.app` and puts the `devrecall` CLI on your `PATH`.

**Linux / WSL** — CLI and MCP server (no desktop app):

```bash
brew install pavelpilyak/devrecall/devrecall-cli
```

Without Homebrew, grab the tarball directly:

```bash
curl -L https://github.com/pavelpilyak/devrecall/releases/latest/download/devrecall-linux-x86_64.tar.gz \
  | tar xz && sudo mv devrecall-linux-x86_64 /usr/local/bin/devrecall
```

Supported on Ubuntu 22.04+ and equivalent (Debian 12+, Fedora 35+).

**Windows** — no native build. Everything except the desktop app runs under
WSL using the Linux instructions above, including the MCP server, which your
editor can spawn across the WSL boundary.

<details>
<summary>Build from source</summary>

```bash
git clone https://github.com/pavelpilyak/devrecall.git
cd devrecall
make build          # → bin/devrecall
```

Requires Go 1.22+ with CGO enabled (for SQLite FTS5).

</details>

Then connect a source and generate your first standup:

```bash
devrecall auth github      # or: slack, google, jira, linear, notion, gitlab, bitbucket
devrecall standup
```

Full install + setup walkthrough at **[docs.devrecall.dev/install](https://docs.devrecall.dev/install/)**.

## Development

```bash
make build              # bin/devrecall
make test               # tests with race detector
make lint               # golangci-lint
```

Build tags: `fts5` enables SQLite full-text search; `GO` enables hugot's pure
Go ONNX backend for embeddings.

The desktop app (Tauri + Svelte) lives in [`desktop/`](desktop/);
the OAuth callback relay (Cloudflare Worker) in [`relay/`](relay/).

## Contributing

Bug reports and collector contributions are especially welcome.
See [CONTRIBUTING.md](CONTRIBUTING.md).

## Security

[SECURITY.md](SECURITY.md) for responsible disclosure.

TDQS

A3.9/5.0

Scored across 17 tools

Disambiguation4/5

Most tools have clearly distinct purposes—search, list, count, drill-down, and work-item aggregation are separated well. The main overlaps are get_related_activities vs get_work_item, and search_activities vs semantic_search_activities, but the descriptions provide enough guidance to choose correctly.

Naming Consistency4/5

The core set follows a consistent verb_noun snake_case pattern like list_activities, count_activities, and resolve_person. A few names deviate—who_worked_on, recent_decisions, current_time, and the abbreviated prep_meeting—but the overall style remains readable and predictable.

Tool Count4/5

At 17 tools, this is slightly above the ideal 3-15 range, but the server covers a broad domain spanning activity search, work items, people, summaries, and meeting prep. Most tools earn their place and support distinct workflows rather than padding the surface.

Completeness4/5

The read/query surface is strong: search, list, count, drill-down, person resolution, work-item aggregation, and pre-built summaries cover the main recall workflows. The notable gap is that log_event supports creating manual notes but there is no update or delete path, and there is no explicit metadata tool for enumerating sources or types.

Maintenance

ActivityActive
ResponsivenessNo issues