litman 1.3.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

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