Keep every paper you read on your own computer, and let an AI assistant do the filing.
Open a paper, highlight it, write your notes beside it — everything stays in ordinary files and folders that you can read, copy, and back up yourself, with or without litman. For anything past reading, just say what you want — add this paper, which ones did I read for the peptide project? — and your AI assistant does it.
Install
macOS / Linux:
curl -LsSf https://get.litman.dev/install.sh | sh
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://get.litman.dev/install.ps1 | iex"
Double-click the litman icon the installer creates — desktop on Windows, Launchpad on macOS, applications menu on Linux.
Install with pipx
pipx builds litman's environment from the Python already on
your machine, so it needs Python 3.12 or newer on your PATH.
pipx install litman
lit gui --make-shortcut # the icon — the one-line installer does this step for you
Install from a local clone (development)
# first install
git clone https://github.com/wqx1999/litman.git
cd litman
pipx install .
# update (pull latest code first)
git pull
pipx install --force .
The AI assistant
Pick an agent to drive litman through its bundled skills; you bring the model — use whatever you already pay for. Start with Claude Code.
| Agent CLI | Recommended model |
|---|---|
| Claude Code | Official subscription |
| Codex | Official subscription |
| Antigravity CLI | Official subscription |
| Cursor | Composer 2.5 |
| OpenCode | MiniMax-M3 |
Every write is validated, so a weaker model just needs more turns — it never corrupts the library. Scores and method: agent model benchmark.
Update and uninstall
Update litman
When a new release is out, a chip with its version number appears next to the logo in the Web UI. Click it and choose Update & restart: litman closes, upgrades, and reopens by itself.
From a terminal, lit self-update does the same through whichever tool
installed litman, uv or pipx. It prints current → latest and asks once.
litman asks PyPI for the newest version number once a day, and mentions it when
yours is older; lit hello tells you every time you ask.
LITMAN_NO_UPDATE_CHECK=1 switches all of it off —
what it checks.
Uninstall litman
Two steps, in order, while the lit command still exists:
lit uninstall # bundled skills, desktop shortcut, shell completion, vault registry, agent preferences, app-window browser profile
uv tool uninstall litman # or: pipx uninstall litman
lit uninstall lists what it will delete and asks first — --dry-run previews,
-y skips the prompt. Your vault (papers, PDFs, notes, annotations) is never
touched by any of this; delete that directory by hand if you want the data gone.
Documentation
Full documentation lives under docs/. New to litman? The
tutorial covers about 80% of everyday use.
| Topic | File |
|---|---|
| Start here — docs map | docs/0-readme.md |
| Design philosophy | docs/1-philosophy.md |
| Four-layer architecture | docs/2-architecture.md |
| Concepts and field reference | docs/3-concepts.md |
| Command reference | docs/4-commands.md |
| Tutorial | docs/5-tutorial.md |
| Agent model benchmark | docs/6-agent-benchmark.md |
Acknowledgments
Developed in the Süssmuth Lab, Technische Universität Berlin, with access to the TU Berlin HPC cluster.
Built with:
Standing on:
Cloud sync runs on rclone, installed separately.
The litman wordmark is adapted from Nunito.
License
MIT. See LICENSE.
AI agents: a condensed, link-dense map of this project lives in README-Agent.md.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file litman-1.3.2.tar.gz.
File metadata
- Download URL: litman-1.3.2.tar.gz
- Upload date:
- Size: 2.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
59e8e029e737598f8830261c68a7b68a9df92a1e3216285b4d415326f5aa5b53
|
|
| MD5 |
313bf3cd5d89bb4c8cee383af356994c
|
|
| BLAKE2b-256 |
266e7743dd6fb0477bd114e9846de7a6e9566a894f9b4698e0f3d52667070d39
|
File details
Details for the file litman-1.3.2-py3-none-any.whl.
File metadata
- Download URL: litman-1.3.2-py3-none-any.whl
- Upload date:
- Size: 2.0 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bab20285e2cb083d4c200e76e1ef7209f46fdb3914d29c5aae9f7a559d55b670
|
|
| MD5 |
1fccab575828c764d24bcd1415297ab3
|
|
| BLAKE2b-256 |
9d828cbc2e9bd42e342601fc6d05204c988f7f688b984b33676ec68044840aa7
|