Skip to content

litman 1.0.0 — first stable release

Choose a tag to compare

View all tags
@wqx1999 wqx1999 released this 09 Jun 14:50
· 368 commits to main since this release
v1.0.0
6f683fc

litman is a local-first, AI-augmented literature manager: a command-line tool (lit) over a plain-file vault where every paper lives in one folder of YAML metadata, notes, and the original PDF. It works fully by hand, with optional Claude Code skills that let an AI agent operate it for you. This is the first stable release.

Highlights

  • 📁 Long-term local vault — everything is plain text (YAML + markdown + PDFs) on your disk. No cloud database, no lock-in: back it up anywhere and grep` the whole library.
  • 🧭 Consistent by design — topics, methods, projects, and sources are governed by a shared TAXONOMY.md controlled vocabulary; atomic operations keep cross-references clean, and lit health-check catches drift.
  • 🔗 Paper ↔ project ↔ code — bind one paper to many projects (each gets a symlinked folder and an auto-generated REFERENCES.md), and to its official code repository cloned inside the vault.
  • 🤖 AI-native CLI — two bundled Claude Code skills (lit-library, lit-reading`) let an agent drive the CLI. The agent proposes, the CLI
    validates and writes, so the library stays correct even with an imperfect model.

Install

pipx install litman
lit setup   # one-shot setup wizard

Requires Python 3.12+.

Links

- 📦 PyPI: https://pypi.org/project/litman/1.0.0/
- 📖 Documentation: https://github.com/wqx1999/litman/blob/main/docs/0-readme.md
- 🚀 Tutorial: https://github.com/wqx1999/litman/blob/main/docs/5-tutorial.md
Assets 2
Loading