Skip to content
Back to search

linggen

MarketplaceWorks with Claude CodeGitHub

Linggen's plugin marketplace.

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

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

HTML

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

Install

Install instructions from the README

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

These steps run a script from the network that findsafeskills does not scan.

**The Mac app** — launcher with all apps below, menubar companion included:

curl -fsSL https://linggen.dev/install-app.sh | bash

**Engine only** — CLI + web UI, macOS and Linux (glibc 2.39+, Ubuntu 24.04 or newer):

curl -fsSL https://linggen.dev/install.sh | bash
ling

Opens the web UI at `http://localhost:9527`.

**Releases** — the Mac app (signed and notarized): [linggen-releases](https://github.com/linggen/linggen-releases/releases/latest) · the engine: [linggen/linggen](https://github.com/linggen/linggen/releases/latest) · what changed: [CHANGELOG.md](CHANGELOG.md)

**iPhone** — [Linggen on the App Store](https://apps.apple.com/app/id6798304906).

---

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.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "linggen",
  3. "description": "Linggen's plugin marketplace.",
  4. "owner": {
  5. "name": "Linggen",
  6. "url": "https://linggen.dev"
  7. },
  8. "plugins": [
  9. {
  10. "name": "linggen",
  11. "description": "Linggen for Claude Code — durable cross-host memory, delegated agents and browser control in your own Chrome, all from one local program (Linggen, `ling`) through one MCP server at /mcp, twelve tools. Installs Linggen (background download) on first session start.",
  12. "category": "productivity",
  13. "homepage": "https://linggen.dev",
  14. "source": "./plugins/linggen"
  15. }
  16. ]
  17. }
README.md · README · 253 lines · 3 findings marked
  1. <p align="center">
  2. <img src="logo.svg" width="120" alt="Linggen" />
  3. </p>
  4. <h1 align="center">Linggen</h1>
  5. <p align="center">
  6. <strong>Your personal AI assistant, on your own Mac and iPhone.</strong><br>
  7. Ling and Yinyue look after a few parts of your life — music, money, health
  8. and play — and remember you across all of them. Local-first: it runs on
  9. your machine, with the model you choose.
  10. </p>
  11. <p align="center">
  12. <a href="https://linggen.dev">Website</a> &middot;
  13. <a href="https://linggen.dev/#inside">Apps</a> &middot;
  14. <a href="https://linggen.dev/docs">Docs</a>
  15. </p>
  16. <p align="center">
  17. <a href="https://github.com/linggen/linggen/releases"><img src="https://img.shields.io/github/v/release/linggen/linggen?style=flat-square" alt="Release" /></a>
  18. <a href="https://github.com/linggen/linggen/blob/main/LICENSE"><img src="https://img.shields.io/github/license/linggen/linggen?style=flat-square" alt="Apache 2.0 License" /></a>
  19. <a href="https://github.com/linggen/linggen/stargazers"><img src="https://img.shields.io/github/stars/linggen/linggen?style=flat-square" alt="Stars" /></a>
  20. </p>
  21. <p align="center">
  22. <img src="doc/media/demo.gif" width="800" alt="Linggen — CFO catches a double charge in locally-parsed statements, Apple Shifu scores your Mac's health, DJ runs karaoke with synced lyrics" />
  23. </p>
  24. <p align="center">
  25. <sub><strong>CFO</strong> catches a $389 double charge (statements never leave your Mac) · <strong>Apple Shifu</strong> scores your Mac's health · <strong>DJ</strong> runs karaoke night. <a href="https://linggen.dev">Full demo →</a></sub>
  26. </p>
  27. ---
  28. ## Install
  29. **The Mac app** — launcher with all apps below, menubar companion included:
  30. ```bash
  31. curl -fsSL https://linggen.dev/install-app.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 40 on GitHub
  32. ```
  33. **Engine only** — CLI + web UI, macOS and Linux (glibc 2.39+, Ubuntu 24.04 or newer):
  34. ```bash
  35. curl -fsSL https://linggen.dev/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 46 on GitHub
  36. ling
  37. ```
  38. Opens the web UI at `http://localhost:9527`.
  39. **Releases** — the Mac app (signed and notarized): [linggen-releases](https://github.com/linggen/linggen-releases/releases/latest) · the engine: [linggen/linggen](https://github.com/linggen/linggen/releases/latest) · what changed: [CHANGELOG.md](CHANGELOG.md)
  40. **iPhone** — [Linggen on the App Store](https://apps.apple.com/app/id6798304906).
  41. ---
  42. ## What it looks after
  43. Linggen is not a general chatbot and not an app store. It is one assistant
  44. that takes a few parts of everyday life and does them well. Two share the
  45. job: **Ling** does the work, **Yinyue** keeps you company and speaks up when
  46. something matters — the same two on your Mac and your iPhone.
  47. - **Music · DJ** — tell it a vibe and it curates a set, builds your local music library with clean tags, syncs tracks to your phone, and does karaoke with synced, translated lyrics.
  48. - **Money · CFO** — a personal CFO that never uploads your money data. Drop in bank/card CSV or PDF exports: deterministic local code parses them into a spend report — monthly trends, subscriptions, commitments, transfer detection, duplicate-charge checks. The AI layer only explains and reviews, and account numbers are stripped before it sees even the redacted totals. [60-second demo](https://linggen.dev/cfo-demo.mp4).
  49. - **Health** — your iPhone reads Apple Health and keeps your body data on the device. Ask what a week did to you or why a number moved, and get the answer in your own numbers. Wellness only.
  50. - **Play · 灵境 (Lingjing)** — a cultivation story with ink-wash scenes, card duels and small games. Plays on the Mac and the iPhone; your save syncs through your account.
  51. - **Play · Games** — Chinese Chess and Gomoku where the model actually plays you, plus Snake, Pong, and Tetris.
  52. - **Your devices · Apple Shifu** — AI health analyst for your Mac: disk, security, performance, dormant apps, buyer's guide. Recommends; never acts on its own.
  53. It remembers you: one memory on your machine, shared by Ling and Yinyue.
  54. ---
  55. ## Yinyue — your desktop companion
  56. A VRM avatar and conversational companion built into the runtime — the face the
  57. agents wear. She reads the room (whether you're typing, reading, or away), voices
  58. the moments that matter in her own words, and gives the agents a way to talk to
  59. each other and to you.
  60. - **She heralds your agents.** When one is blocked waiting on you, fails, or
  61. finishes a background job, Yinyue says so — and stays quiet on the routine.
  62. - **Relay an answer.** When an agent is parked on a question or a permission,
  63. just tell Yinyue "approve" — she carries your word back and it unblocks.
  64. - **`agent_chat`.** Agents message each other. Ask Yinyue to have Ling introduce
  65. itself and the message lands in your chat (`[Yinyue]: …`) and Ling replies;
  66. tell Ling to make Yinyue dance and she dances. A loop-break keeps you in the loop.
  67. - **She's present.** Gestures and moods (`Express`), occasional unprompted
  68. remarks, a local voice with lip-sync.
  69. She's an ordinary Linggen session on the `yinyue` agent — swap her model, edit
  70. her persona, or build another companion the same way. See
  71. [`doc/yinyue-companion-spec.md`](doc/yinyue-companion-spec.md).
  72. ---
  73. ## For developers: how it is built
  74. Skills, agents, missions — all files. New apps are a folder away. Browse community skills at [github.com/linggen/skills](https://github.com/linggen/skills).
  75. - **Memory** — cross-agent semantic memory, part of Linggen: the same store reachable from Linggen, Claude Code, or Codex through the [`linggen` plugin](plugins/linggen).
  76. - **Model sharing** — open a room and let friends use your models over P2P WebRTC. No keys for the consumer, no cloud middleman; the owner controls budget and tools.
  77. Architecturally, Linggen is **the root system for AI agents**. The core
  78. runtime manages agent processes, communication, and execution; everything
  79. else (skills, agents, missions) grows on top as files. An "AI app" in
  80. Linggen is a skill, an agent, or a mission — markdown + scripts, not code
  81. plugins. The runtime gives every app a process, syscalls (built-in tools),
  82. a filesystem (memory), permissions, and a network surface (P2P rooms).
  83. Apps drop into a folder and run.
  84. ### OS analogy
  85. | OS | Linggen |
  86. |:---|:---|
  87. | Process | Agentic loop — one running agent |
  88. | Interrupt | User message queue — checked each iteration |
  89. | Thread / Fork | Subagent delegation — concurrent child execution |
  90. | Syscall | Tool call — built-in tools are the kernel API |
  91. | Dynamic library | Skill — loaded at runtime, no code changes |
  92. | Cron job | Mission — scheduled agent / app / script |
  93. | Driver | Model provider — Ollama, Claude, GPT, Gemini, Bedrock |
  94. | Filesystem | Memory store — LanceDB, hosted by the engine |
  95. | Process privilege | Permission modes (chat / read / edit / admin) + path scoping |
  96. | Network share | Rooms — share models with peers over P2P WebRTC |
  97. Full table and design principles in [`doc/product-spec.md`](doc/product-spec.md);
  98. vision and roadmap in [`doc/insight.md`](doc/insight.md).
  99. ---
  100. ## Add an app
  101. Drop a markdown file in `~/.linggen/` — available immediately, no restart:
  102. ```markdown
  103. ---
  104. # ~/.linggen/agents/reviewer.md
  105. name: reviewer
  106. description: Code review specialist.
  107. tools: ["Read", "Glob", "Grep"]
  108. model: claude-sonnet-5
  109. ---
  110. You review code for bugs, style issues, and security vulnerabilities.
  111. ```
  112. Skills (`~/.linggen/skills/<name>/SKILL.md`) and missions (cron-scheduled
  113. agent / app / script) follow the same drop-in pattern. Skills use the open
  114. [Agent Skills](https://agentskills.io) standard and work in Claude Code
  115. and Codex too.
  116. ---
  117. ## Where Linggen sits
  118. - **Local-first.** Runtime, data, and inference (when you pick local models) live on your machine. Cloud is opt-in via your own API keys.
  119. - **Model-agnostic.** Any model — Ollama, Claude, GPT, Gemini, DeepSeek, Groq, OpenRouter. Routing policies (`local-first`, `cloud-first`, custom) decide which model handles each request.
  120. - **Curated, not general.** One personal assistant for a few parts of life — music, money, health, play.
  121. - **P2P, not centralized.** Remote access and model sharing flow over WebRTC data channels. `linggen.dev` acts as a signaling relay; it does not see chat content.
  122. - **Skills as the contract.** Apps follow the open Agent Skills standard.
  123. ---
  124. ## Remote access
  125. Sign in from the app (or `ling account login`). Signing in links this machine
  126. automatically — there is no separate step.
  127. Then open `linggen.dev/app` from any browser. P2P-encrypted tunnel back to
  128. your machine; no VPN, no port forwarding.
  129. ---
  130. ## Hand work to Linggen from Claude Code or Codex (MCP)
  131. The daemon is one MCP server at `http://127.0.0.1:9527/mcp`, with twelve
  132. tools: memory (5), agents (4) and browser (3). Its `agent_run`
  133. tool lets another agent hand a task to a local Linggen agent:
  134. - **A different model does the work.** The Linggen agent runs on whatever you
  135. have set up here: a ChatGPT plan, a local model through Ollama, or an API
  136. key. The caller spends tokens on the brief and the answer, not on the file
  137. reads and test runs in between.
  138. - **Writes stay in one folder.** The caller passes a git worktree as
  139. `write_dir`. Everything else on disk is read-only to the agent.
  140. - **The caller answers permission requests.** A request for more goes back
  141. over a WebSocket to the agent that called; it answers with `agent_permit`
  142. (`allow_once`, `allow_session` or `deny`). No answer in ten minutes is a deny.
  143. - **Long jobs run in the background.** `agent_run` returns a session id, and
  144. one frame arrives when the job ends. `agent_status` with `op: session` has the reply.
  145. The story of using it day to day, with what the second agent got wrong:
  146. [My Claude Code quota kept running out…](https://linggen.dev/blog/claude-code-hands-work-to-chatgpt-plan)
  147. The same server carries the browser tools (`browser_open`, `browser_read`,
  148. `browser_act`: drive one visible tab in your own Chrome, with per-site
  149. permission prompts) and Linggen's durable memory (`memory_search`,
  150. `memory_add`, `memory_update`, `memory_delete`, `memory_upkeep`). Another
  151. computer you have approved sees the five memory tools only.
  152. `agent_status` with `op: models` says which model can be used now and, for one
  153. that cannot, why. A run that stops on a usage limit says so with its reset
  154. time.
  155. On Claude Code / Codex, install the `linggen` plugin (source:
  156. [`plugins/linggen`](plugins/linggen)). It adds the one server and the per-turn
  157. memory recall hook, and installs Linggen on first session start:
  158. ```bash
  159. # Claude Code
  160. claude plugin marketplace add linggen/linggen --sparse .claude-plugin plugins
  161. claude plugin install linggen@linggen
  162. # Codex
  163. codex plugin marketplace add linggen/linggen
  164. codex plugin add linggen@linggen
  165. ```
  166. The browser tools need the Chrome extension, whose source is in this repo:
  167. [`browser-extension/`](browser-extension).
  168. Without git (a fresh Mac): `curl -fsSL https://linggen.dev/install-plugin.sh | bash`.
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 227 on GitHub
  169. Then pick the model the Linggen agent runs on: in Linggen, Settings → Models →
  170. **Sign in with ChatGPT**, or add an API key, or choose a local model.
  171. Any other MCP client just points at the endpoint. Details in
  172. [`doc/mcp-spec.md`](doc/mcp-spec.md).
  173. ---
  174. ## Documentation
  175. - [Design docs](doc/) — architecture, specs, internals
  176. - [Product spec](doc/product-spec.md) — system definition + design principles
  177. - [Insight](doc/insight.md) — vision, roadmap, problems Linggen solves
  178. - [Skill spec](doc/skill-spec.md) — how to write skills
  179. - [Full docs](https://linggen.dev/docs) — guides and reference
  180. ## Credits
  181. - Character animation credits to pixiv Inc.'s VRoid Project.
  182. ---
  183. ## License
  184. Apache 2.0 — engine and bundled skills. Branded apps shipped from [linggen-releases](https://github.com/linggen/linggen-releases) ship under their own terms.

Ratings and comments

Sign in to rate this skill.

Sign in

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