litman 1.3.5

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.

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

Pick an agent to drive litman through its bundled skills; you bring the model — use whatever you already pay for. Start with Claude Code.

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

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 at litman.dev/docs. New to litman? The tutorial covers about 80% of everyday use.

• Start here — docs map
• Design philosophy
• Four-layer architecture
• Concepts and field reference
• Command reference
• Tutorial
• Agent model benchmark
• Changelog

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.

Contact

Issues are the fastest route for a bug or a feature request. For anything else, or if you are not on GitHub: contact@litman.dev. Security problems go to the same address, privately — see SECURITY.md.

License

Copyright (C) 2026 Qingxin Wang.

litman is free software under the GNU Affero General Public License, version 3 or later — see LICENSE. Use it for anything, including commercially. If you modify litman and pass it on — shipping a build, or running it where other people can reach it over a network — the modified source has to be available under the same licence.

Up to and including 1.3.4, litman was released under the MIT licence; those versions stay MIT.

_{AI agents: a condensed, link-dense map of this project lives in README-Agent.md.}