关于 Lific
Lific 是面向个人协调多个 Agent 的本地优先问题跟踪器,以单个 SQLite 文件和内置 MCP 服务保存计划与问题,让工作跨会话延续。它提供 Web 界面和命令行工具。
主要功能
- 01单二进制与 SQLite 存储
- 02问题、计划及页面管理
- 03MCP 工具与活动记录
- 04Web 界面和命令行工具
- 05自动备份与恢复
适用场景
- 01跨会话恢复项目进度
- 02跟踪问题阻塞与负责人
- 03通过证据关闭已完成问题
- 04用多个 Agent 协调个人工作
MCP 相关
内置 MCP 服务向客户端提供问题、计划、页面、评论、附件、搜索和活动等工具。`lific connect` 可为多个 AI 客户端写入 MCP 配置。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
为高产 Agent 打造的问题跟踪器。
一个二进制文件。一个 SQLite 文件。内置 MCP。
计划和问题存储在你的服务上,而不是上下文窗口中,因此工作成果不会随会话结束而消失。Agent 通过 MCP 使用它;你则使用 Web UI。
- 31 个 MCP 工具,仅需 5,781 个 token,大约相当于读取一个较长的文件。
- 一个 25 到 32 MB 的二进制文件,内置 SQLite、Web UI 和备份功能。无需 Docker,也无需 Postgres。
lific connect可为 11 款 AI 客户端写入 MCP 配置。- 使用
APP-42这样的标识符,绝不使用 UUID。
60 秒快速设置
cargo install lific # or Homebrew (below), or download a binary from Releases
lific init # config, database, admin account, background service on :3456
lific connect # MCP config for your AI clients
重启你的 AI 客户端。Web UI 位于 http://localhost:3456。`lific doctor` 会检查配置、数据库、服务和 MCP 往返通信;如果有任何问题,会以非零状态码退出。
- 在 macOS 和 Linux 上,
brew install voidnullable/tap/lific可替代cargo install:几秒内即可安装发布版二进制文件,无需 Rust 工具链。 lific init --here会将配置和数据库保存在当前目录。lific init --no-service会跳过后台服务;你可以自行运行lific start。service status | restart | stop | uninstall可管理服务。
你的 Agent 可以做什么
| 调用 | 功能 |
|---|---|
get_briefing(project="APP") | 恢复项目工作:查看计划和后续步骤、受阻和可处理的问题;还可通过 since 查看变更内容 |
list_issues(project="APP", workable=true) | 查看所有阻塞项均已解决的未结问题 |
list_issues(members=["me"]) | 查看你在所属项目中的所有进行中工作 |
create_plan / get_plan | 创建跨会话保留的嵌套步骤计划;某个步骤及其问题会同时关闭 |
link_issues(target="APP-9", relation_type="blocks", user="ada") | 将问题设置为受某个人或日期范围阻塞,而不仅仅受另一个问题阻塞 |
update_issue(assignees=["human"]) | 标记必须由某个人完成的工作;Agent 会接手未分配的问题 |
update_issue(status="done", evidence="cargo test: 412 passed") | 关闭问题,并将证明保存为验证评论 |
edit_issue / edit_page | 修改单个字符串,无需重新发送整个文档 |
get_activity(identifier="APP", since="2026-10-01") | 查看你离开期间谁做了什么更改 |
每个 AI 工具都会以你账号下的独立机器人身份连接。历史记录会显示“OpenCode 关闭了 APP-42”,你也可以撤销某个工具的权限,而不影响其他工具。
MCP 工具
| 类别 | 工具 |
|---|---|
| 问题 | list_issues · get_issue · create_issue · update_issue · bulk_update · edit_issue · get_board |
| 关联和等待 | link_issues · unlink_issues |
| 页面 | get_page · create_page · update_page · edit_page |
| 计划 | create_plan · get_plan · edit_plan_step · update_plan_step |
| 评论 | add_comment · list_comments · edit_comment · delete_comment |
| 附件 | upload_attachment · get_attachment · list_attachments |
| 搜索和历史记录 | get_briefing · search · get_activity |
| 结构 | list_resources · manage_resource · delete |
| 导出 | export |
这 5,781 个 token 是 tools/list 定义的紧凑 JSON 格式,使用 tiktoken 的 o200k_base 计数。参数和输出:MCP 工具。
连接你的 AI 工具
lific connect 支持 opencode · claude-code · claude-desktop · cursor · vscode · codex · zed · gemini · windsurf · goose · crush。
lific connect # pick from the clients it finds
lific connect --client opencode --client cursor --yes # no prompts
lific connect --client claude-code --scope project # repo-local .mcp.json
lific connect --client zed --stdio # no server: direct SQLite over stdio
它会合并到现有配置中;如果无法解析某个文件,则不会改动该文件,而是打印配置片段。也可以通过客户端使用 OAuth 登录,或在无头机器上运行 lific login:连接 Agent。
适用于任何 MCP 客户端的手动配置
远程连接,通过 Streamable HTTP:
{
"lific": {
"type": "remote",
"url": "http://localhost:3456/mcp",
"headers": { "Authorization": "Bearer your-api-key" }
}
}
本地连接,通过 stdio,无需服务:
{
"lific": {
"type": "local",
"command": ["lific", "--db", "path/to/lific.db", "mcp"]
}
}
使用 lific key create --name my-key --user <you> 创建密钥。未设置 LIFIC_TOKEN 的 stdio 会话将以实例操作员身份运行。
CLI
lific issue list --project APP
lific issue create --project APP --title "Fix login bug" --priority high
lific issue update APP-42 --status done
lific search "authentication" --project APP
lific --backend http --url https://lific.example.com issue list --project APP # after lific login
CLI 可直接读取数据库,也可通过 --backend http 连接远程服务。通过管道传递输出时,格式为 JSON。lific agents-md 会在仓库的 AGENTS.md 中添加一段简短的 Lific 说明。完整参考:CLI。
哪些情况下 Lific 并不适合
- 你要协调一支大型团队,并需要 SSO、冲刺或甘特图。请使用 Linear 或 Plane。
- 你希望将问题存储在仓库本身中。请使用 beads 这类原生支持 Git 的跟踪工具。
- 你需要多个服务彼此同步。一个 Lific 实例就是一个 SQLite 文件。
它专为一个人指挥多个 Agent 而打造。
运行
访问权限。 新安装的实例会在每次调用时检查项目成员资格,包括读取操作。使用 lific member add --project APP --user sam --role maintainer 添加成员。参见自托管。
备份。 Lific 每小时写入一个归档,并保留 24 个。若要单独创建一次备份:
lific dump # database plus attachments, safe while running
lific restore lific_20260703_141500.tar.gz # stop the server first
配置。 lific init 会写入 lific.toml。在将服务开放给 localhost 之外的访问之前,请设置 server.public_url。参见配置。
Docker。 可选;二进制文件无需其他依赖。
docker build -t lific .
docker run -p 3456:3456 -v lific-data:/data \
-e LIFIC_INIT_ADMIN_NAME="Your Name" \
-e LIFIC_INIT_ADMIN_PASSWORD="a long password" \
lific
首次启动时必须设置这两个变量,之后它们会被忽略。
升级。 跳过版本之前,请阅读升级。
从源代码构建
git clone https://github.com/VoidNullable/lific && cd lific
devenv allow && devenv shell
devenv tasks run lific:debug-build
CONTRIBUTING.md 介绍了测试和发布构建。
社区
有疑问、报告错误或获取发布公告:Discord。支持问题在 #support 中能最快得到答复。
贡献
欢迎提交问题和 PR。对于较大的改动,请先创建问题。
MCP Registry
Lific 会将 server.json 发布到 MCP Registry。
mcp-name: io.github.VoidNullable/lific
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。