litman 1.2.1

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://raw.githubusercontent.com/wqx1999/litman/main/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/wqx1999/litman/main/install.ps1 | iex"

Double-click the litman icon the installer creates — desktop on Windows, Launchpad on macOS, applications menu on Linux.

pipx install litman
lit gui --make-shortcut    # the icon — the one-line installer does this step for you

# 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

Reading and annotating work on their own. The just say what you want layer runs on an AI agent, which you install separately — litman ships the skills it drives, not a model. lit agent starts yours in the library directory; the app's agent button does the same.

Claude Code is the supported agent today. Codex, Cursor, Gemini CLI, and OpenCode are next: they already appear in litman's agent picker, greyed out until the release that turns them on.

Your agent works with whatever model you give it. We ran eight of them through 22 everyday tasks:

• Recommended: an Anthropic subscription. Claude Sonnet 4.6 and Haiku 4.5 both complete 97% of the tasks.
• Without one, DeepSeek-V4 scores highest of the rest.

Every write is validated whatever the model, so a weaker one needs more turns but never corrupts the library. Method and per-model scores: agent model benchmark.

Update and uninstall

lit uninstall              # bundled skills, desktop shortcut, shell completion, vault registry, agent preferences, app-window browser profile
uv tool uninstall litman   # or: pipx uninstall litman

Documentation

Full documentation lives under docs/. New to litman? The tutorial covers about 80% of everyday use.

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.}