Skip to content
Back to search

lific

Local-first, lightweight issue tracker. Single Rust binary, SQLite-backed, MCP-native.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/VoidNullable/lific with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/VoidNullable/lific'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/voidnullable--lific/badge.svg)](/listings/voidnullable--lific)

HTML

<a href="/listings/voidnullable--lific"><img src="/api/listings/voidnullable--lific/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

cargo install lific   # or download a binary from Releases
lific init            # config, database, admin account, background service on :3456
lific connect         # MCP config for your AI clients

Restart your AI client. The web UI is at http://localhost:3456. `lific doctor` checks config, database, server and an MCP round trip, and exits nonzero if anything is broken.

- `lific init --here` keeps config and database in the current directory. - `lific init --no-service` skips the background service; run `lific start` yourself. - `lific service status | restart | stop | uninstall` manages the service.

More: [Installation](https://lific.dev/docs/installation) · [Quickstart](https://lific.dev/docs/quickstart)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 201 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="LificHero.png" alt="Lific: an issue tracker for prolific agents" width="800">
  3. </p>
  4. <p align="center">
  5. <a href="https://github.com/VoidNullable/lific/actions/workflows/ci.yml"><img src="https://github.com/VoidNullable/lific/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  6. <a href="https://crates.io/crates/lific"><img src="https://img.shields.io/crates/v/lific" alt="crates.io"></a>
  7. <a href="https://github.com/VoidNullable/lific/releases"><img src="https://img.shields.io/github/v/release/VoidNullable/lific" alt="Release"></a>
  8. <a href="LICENSE"><img src="https://img.shields.io/github/license/VoidNullable/lific" alt="License"></a>
  9. <a href="https://discord.gg/uWvaFC4f7D"><img src="https://img.shields.io/discord/1516612377196363889?logo=discord&logoColor=white&label=discord&color=5865F2" alt="Discord"></a>
  10. </p>
  11. <p align="center">
  12. <strong>An issue tracker for prolific agents.</strong><br>
  13. One binary. One SQLite file. MCP built in.
  14. </p>
  15. <p align="center">
  16. <a href="https://lific.dev"><strong>lific.dev</strong></a>
  17. &nbsp;·&nbsp;
  18. <a href="https://lific.dev/docs">Docs</a>
  19. &nbsp;·&nbsp;
  20. <a href="https://discord.gg/uWvaFC4f7D">Discord</a>
  21. </p>
  22. ---
  23. Plans and issues live on your server instead of in the context window, so work outlives the session. Agents use it over MCP; you use the web UI.
  24. - **32 MCP tools in 7,290 tokens**, about one long file read.
  25. - **One 25 to 32 MB binary** with SQLite, the web UI and backups built in. No Docker, no Postgres.
  26. - **`lific connect` writes MCP config for 11 AI clients.**
  27. - **Identifiers like `APP-42`**, never UUIDs.
  28. ## 60-second setup
  29. ```bash
  30. cargo install lific # or Homebrew / winget (below), or download a binary from Releases
  31. lific init # config, database, admin account, background service on :3456
  32. lific connect # MCP config for your AI clients
  33. ```
  34. Restart your AI client. The web UI is at http://localhost:3456. `lific doctor` checks config, database, server and an MCP round trip, and exits nonzero if anything is broken.
  35. - `brew install voidnullable/tap/lific` replaces `cargo install` on macOS and Linux: a release binary in seconds, no Rust toolchain.
  36. - `winget install VoidNullable.lific` does the same on Windows.
  37. - `lific init --here` keeps config and database in the current directory.
  38. - `lific init --no-service` skips the background service; run `lific start` yourself.
  39. - `lific service status | restart | stop | uninstall` manages the service.
  40. More: [Installation](https://lific.dev/docs/installation) · [Quickstart](https://lific.dev/docs/quickstart)
  41. ## What your agent can do
  42. | Call | What it does |
  43. | --- | --- |
  44. | `get_briefing(project="APP", since="last")` | Resume a project: the human queue across projects, what changed since your last briefing, plans and next steps, blocked and workable issues |
  45. | `list_issues(project="APP", workable=true)` | Open issues whose blockers are all resolved |
  46. | `list_issues(members=["me"])` | Your active work across the projects you belong to |
  47. | `create_plan` / `get_plan` | Nested step plans that survive the session; a step and its issue close together |
  48. | `link_issues(target="APP-9", relation_type="blocks", user="ada")` | Block an issue on a person or a date window, not only another issue |
  49. | `update_issue(assignees=["human"])` | Mark work a person must do; agents take unassigned issues |
  50. | `update_issue(status="done", evidence="cargo test: 412 passed")` | Close with the proof saved as a verification comment |
  51. | `edit_issue` / `edit_page` | Change one string without resending the document |
  52. | `get_activity(identifier="APP", since="2026-10-01")` | Who changed what while you were away |
  53. Each AI tool connects as its own bot under your account. The history says "OpenCode closed APP-42", and you can revoke one tool without touching the others.
  54. ## MCP tools
  55. | Family | Tools |
  56. | --- | --- |
  57. | Issues | `list_issues` · `get_issue` · `create_issue` · `update_issue` · `move_issue` · `bulk_update` · `edit_issue` · `get_board` |
  58. | Relations and waits | `link_issues` · `unlink_issues` |
  59. | Pages | `get_page` · `create_page` · `update_page` · `edit_page` |
  60. | Plans | `create_plan` · `get_plan` · `edit_plan_step` · `update_plan_step` |
  61. | Comments | `add_comment` · `list_comments` · `edit_comment` · `delete_comment` |
  62. | Attachments | `upload_attachment` · `get_attachment` · `list_attachments` |
  63. | Search and history | `get_briefing` · `search` · `get_activity` |
  64. | Structure | `list_resources` · `manage_resource` · `delete` |
  65. | Export | `export` |
  66. The 7,290 tokens are the `tools/list` definitions as compact JSON, counted with tiktoken's o200k_base. Parameters and output: [MCP tools](https://lific.dev/docs/mcp/tools).
  67. ## Connect your AI tools
  68. `lific connect` supports `opencode` · `claude-code` · `claude-desktop` · `cursor` · `vscode` · `codex` · `zed` · `gemini` · `windsurf` · `goose` · `crush`.
  69. ```bash
  70. lific connect # pick from the clients it finds
  71. lific connect --client opencode --client cursor --yes # no prompts
  72. lific connect --client claude-code --scope project # repo-local .mcp.json
  73. lific connect --client zed --stdio # no server: direct SQLite over stdio
  74. ```
  75. It merges into existing config, and leaves a file it can't parse alone and prints the snippet instead. OAuth sign-in from the client and `lific login` for headless machines also work: [Connect agents](https://lific.dev/docs/connect).
  76. <details>
  77. <summary>Manual config for any MCP client</summary>
  78. Remote, over Streamable HTTP:
  79. ```json
  80. {
  81. "lific": {
  82. "type": "remote",
  83. "url": "http://localhost:3456/mcp",
  84. "headers": { "Authorization": "Bearer your-api-key" }
  85. }
  86. }
  87. ```
  88. Local, over stdio with no server:
  89. ```json
  90. {
  91. "lific": {
  92. "type": "local",
  93. "command": ["lific", "--db", "path/to/lific.db", "mcp"]
  94. }
  95. }
  96. ```
  97. Create a key with `lific key create --name my-key --user <you>`. A stdio session without `LIFIC_TOKEN` acts as the instance operator.
  98. </details>
  99. ## CLI
  100. ```bash
  101. lific issue list --project APP
  102. lific issue create --project APP --title "Fix login bug" --priority high
  103. lific issue update APP-42 --status done
  104. lific search "authentication" --project APP
  105. lific --backend http --url https://lific.example.com issue list --project APP # after lific login
  106. ```
  107. The CLI reads the database directly, or a remote server with `--backend http`. Output is JSON when piped. `lific agents-md` adds a short Lific section to a repo's `AGENTS.md`. Full reference: [CLI](https://lific.dev/docs/cli).
  108. ## When Lific is the wrong tool
  109. - You coordinate a large team and need SSO, sprints or Gantt charts. Use Linear or Plane.
  110. - You want issues stored in the repo itself. Use a git-native tracker such as beads.
  111. - You need several servers syncing with each other. One Lific instance is one SQLite file.
  112. It's built for one person directing several agents.
  113. ## Running it
  114. **Access.** New installs check project membership on every call, reads included. Add people with `lific member add --project APP --user sam --role maintainer`. See [Self-hosting](https://lific.dev/docs/self-hosting).
  115. **Backups.** Lific writes an archive every hour and keeps 24. For a one-off:
  116. ```bash
  117. lific dump # database plus attachments, safe while running
  118. lific restore lific_20260703_141500.tar.gz # stop the server first
  119. ```
  120. **Config.** `lific init` writes `lific.toml`. Set `server.public_url` before exposing the server beyond localhost. See [Configuration](https://lific.dev/docs/configuration).
  121. **Docker.** Optional; the binary needs nothing else.
  122. ```bash
  123. docker build -t lific .
  124. docker run -p 3456:3456 -v lific-data:/data \
  125. -e LIFIC_INIT_ADMIN_NAME="Your Name" \
  126. -e LIFIC_INIT_ADMIN_PASSWORD="a long password" \
  127. lific
  128. ```
  129. Both variables are required on first boot and ignored after it.
  130. **Upgrading.** Read [Upgrading](https://lific.dev/docs/upgrading) before you skip versions.
  131. ## Build from source
  132. ```bash
  133. git clone https://github.com/VoidNullable/lific && cd lific
  134. devenv allow && devenv shell
  135. devenv tasks run lific:debug-build
  136. ```
  137. [CONTRIBUTING.md](CONTRIBUTING.md) covers tests and release builds.
  138. ## Community
  139. Questions, bug reports and release announcements: [Discord](https://discord.gg/uWvaFC4f7D). Support questions get answered fastest in #support.
  140. ## Contributing
  141. Issues and PRs welcome. For anything large, open an issue first.
  142. ## MCP Registry
  143. Lific publishes `server.json` to the [MCP Registry](https://registry.modelcontextprotocol.io).
  144. - `mcp-name: io.github.VoidNullable/lific`
  145. ## License
  146. [Apache-2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.