Metadata-Version: 2.4
Name: dejaview
Version: 0.2.0
Summary: Terminal dashboard for all your Claude Code sessions, across every project
Project-URL: Homepage, https://github.com/dotbrt/dejaview
Project-URL: Repository, https://github.com/dotbrt/dejaview
Project-URL: Issues, https://github.com/dotbrt/dejaview/issues
Author: dotbrt
License-Expression: MIT
License-File: LICENSE
Keywords: claude,claude-code,sessions,terminal,textual,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Topic :: Terminals
Requires-Python: >=3.10
Requires-Dist: textual>=1.0
Description-Content-Type: text/markdown

# dejaview

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue?style=flat-square&logo=python&logoColor=white)](pyproject.toml)
[![Built with Textual](https://img.shields.io/badge/Built%20with-Textual-5967ff?style=flat-square)](https://textual.textualize.io/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](https://github.com/dotbrt/dejaview/pulls)

Terminal dashboard for all your [Claude Code](https://claude.com/claude-code) sessions, across every project on your machine.

You use Claude Code everywhere. A refactor here, a side project there, a bugfix you swore you'd finish after lunch - three days ago. `claude --resume` only helps if you remember *which directory* you were in. The rest is `cd`-and-guess archaeology.

dejaview turns that pile of forgotten sessions into a dashboard:

- **See everything at once** - every project you've touched, sorted by recency, with a 14-day activity sparkline
- **Know where you left off** - each session shows its title, your last prompt, how it started, duration, and git branch
- **Jump straight back in** - hit `Enter` and you're resumed, in the right directory, on the right session
- **Zero setup** - no config, no daemon, no account. Run it and it finds your sessions.

![dejaview dashboard](assets/demo-projects.svg)

<details>
<summary>More screenshots</summary>

Drilling into a session - last prompt, how it started, and the ready-to-paste resume command:

![session detail view](assets/demo-session.svg)

</details>

## Install

Try it without installing ([uv](https://docs.astral.sh/uv/)):

```sh
uvx dejaview
```

Keep it:

```sh
uv tool install dejaview   # or: pipx install dejaview
```

Or straight from the repo:

```sh
uv tool install git+https://github.com/dotbrt/dejaview
```

Sessions are read from `~/.claude/projects`. If yours live elsewhere:

```sh
dejaview --dir /path/to/projects
```

## Keys

| Key     | Action                                    |
| ------- | ----------------------------------------- |
| `Enter` | resume selected session (or jump to pane) |
| `c`     | copy resume command to clipboard          |
| `r`     | rescan transcripts                        |
| `Tab`   | switch pane                               |
| `Esc`   | back to projects pane                     |
| `q`     | quit                                      |

## How it works

Read-only, local-only. It parses the `*.jsonl` transcripts in `~/.claude/projects/`, counts human prompts (ignoring hooks, sidechains, and system noise), and groups sessions by working directory. Nothing is written and nothing leaves your machine.

Built with [Textual](https://textual.textualize.io/).

## License

MIT
