# Send Link Brain to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "link-brain",
    "name": "Link Brain",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jakes420/link-brain",
    "canonicalUrl": "https://clawhub.ai/jakes420/link-brain",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/link-brain",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=link-brain",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/examples.md",
      "references/v4.0.0-release-notes.md",
      "scripts/brain.py",
      "tests/fixtures/hackernews-favorites.json",
      "tests/fixtures/instapaper-export.csv"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "link-brain",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T23:27:49.298Z",
      "expiresAt": "2026-05-11T23:27:49.298Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=link-brain",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=link-brain",
        "contentDisposition": "attachment; filename=\"link-brain-4.3.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "link-brain"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/link-brain"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/link-brain",
    "downloadUrl": "https://openagent3.xyz/downloads/link-brain",
    "agentUrl": "https://openagent3.xyz/skills/link-brain/agent",
    "manifestUrl": "https://openagent3.xyz/skills/link-brain/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/link-brain/agent.md"
  }
}
```
## Documentation

### Link Brain

Your personal bookmark graveyard, except things actually come back.

### Quick Start

python3 scripts/brain.py quickstart           # auto-imports browser bookmarks + opens GUI
python3 scripts/brain.py save "https://example.com" --auto
python3 scripts/brain.py search "that article about sqlite"

### First Run

On first run, use quickstart instead of setup. It:

Creates the database
Scans Chrome, Safari, and Firefox for bookmarks
Imports everything it finds (skips duplicates)
Generates the visual GUI console
Returns JSON with import stats

setup also detects browsers and reports what it finds, but doesn't auto-import. Use quickstart when the user wants the fastest path to a working knowledge base.

### What It Does

Saves URLs with titles, summaries, tags, and metadata
Full-text search with natural language filters
Auto-fetches and summarizes pages locally (no API keys)
Spaced repetition so your saved links don't rot
Collections for organizing reading lists
Knowledge graph visualization
Reading stats, streaks, and weekly digests
Imports from Chrome, Safari, Firefox, Pocket, YouTube, Reddit
Everything in SQLite. Everything on disk. No accounts. No telemetry.

Data lives in ~/.link-brain/. Override with LINK_BRAIN_DIR=/your/path.

### Manual

You know the title. You know what it's about. Just tell it.

python3 scripts/brain.py save "https://docs.python.org" \\
  --title "Python docs" \\
  --summary "Standard library reference." \\
  --tags "python, docs"

### Auto

Point it at a URL. It fetches the page, extracts readable text, generates a summary, and suggests tags based on your existing collection. No LLM needed.

python3 scripts/brain.py auto-save "https://example.com"

Or equivalently:

python3 scripts/brain.py save "https://example.com" --auto

This is the only command that makes a network request. Everything else is local.

### Search

SQLite FTS5 under the hood, but you can write queries like a person.

python3 scripts/brain.py search "last week unread from github"
python3 scripts/brain.py search "best rated rust"
python3 scripts/brain.py search "unrated videos from youtube"
python3 scripts/brain.py search "oldest unread" --limit 10

### Tags

python3 scripts/brain.py tags                    # list all tags
python3 scripts/brain.py tags python             # links tagged "python"

### Related

Find links that share tags with a specific one.

python3 scripts/brain.py related 42

### Tag Suggestions

Get tag ideas for a URL based on your patterns.

python3 scripts/brain.py suggest-tags "https://example.com"

### Discovery

When you don't know what to read next.

digest pulls a batch of links for review
recommend surfaces links based on your most-used tags
gems shows your highest-rated links and hidden finds
random grabs something from the backlog

python3 scripts/brain.py digest
python3 scripts/brain.py recommend
python3 scripts/brain.py gems
python3 scripts/brain.py random

### Reading Tracking

python3 scripts/brain.py read 42                # mark as read
python3 scripts/brain.py unread                  # show unread links
python3 scripts/brain.py rate 42 5               # rate 1-5
python3 scripts/brain.py streak                  # current streak and activity
python3 scripts/brain.py insights                # reading personality, analytics
python3 scripts/brain.py weekly                  # weekly summary, WhatsApp-ready

streak tracks consecutive days you've read something. insights tells you things like your most active hours and top domains. weekly is a formatted digest you can send straight to a chat.

### Collections

Reading lists that reference your saved links.

python3 scripts/brain.py collection create "Rust" --description "Systems stuff"
python3 scripts/brain.py collection add "Rust" 42
python3 scripts/brain.py collection show "Rust"
python3 scripts/brain.py collection list
python3 scripts/brain.py collection remove "Rust" 42
python3 scripts/brain.py collection export "Rust"            # markdown
python3 scripts/brain.py collection export "Rust" --html     # standalone HTML

### Review Queue

Spaced repetition for your bookmarks. Every saved link enters the queue. Intervals grow as you review: 1 day, 3 days, 7 days, and so on.

python3 scripts/brain.py review                  # next due item
python3 scripts/brain.py review done 42          # reviewed, advance interval
python3 scripts/brain.py review skip 42          # not now
python3 scripts/brain.py review reset 42         # back to 1-day interval
python3 scripts/brain.py review stats            # queue overview

### Auto-Save

The --auto flag on save (or the auto-save shortcut) handles fetching, summarizing, and tagging in one shot. It uses urllib to grab the page, extracts the readable content, and picks tags that match your existing vocabulary. No external services involved.

### Knowledge Graph

python3 scripts/brain.py graph --open

Generates a standalone HTML file at ~/.link-brain/graph.html with an interactive canvas. Links are nodes. Shared tags are edges. No external JS libraries. Just open it in a browser.

### GUI Console

python3 scripts/brain.py gui

Opens ~/.link-brain/console.html in your browser. Single self-contained HTML file, nothing external. Includes search, tag cloud, knowledge graph, collections, review queue, reading timeline, and dark/light mode.

Add --no-open to generate without launching.

### Browsers

Pull bookmarks directly:

python3 scripts/brain.py scan chrome
python3 scripts/brain.py scan safari
python3 scripts/brain.py scan firefox

Reads from the browser's local bookmark storage. No export step needed.

### Platforms

Import from exported files:

python3 scripts/brain.py import pocket_export.html
python3 scripts/brain.py import youtube_history.json
python3 scripts/brain.py import reddit_saved.csv

How to get your exports:

Pocket: Go to getpocket.com/export. You'll get an HTML file.
YouTube: Use Google Takeout. Select YouTube, then pick watch history. You'll get a JSON file.
Reddit: Go to reddit.com/prefs/data-request or old.reddit.com and export saved posts.

### Syncing

Check for bookmarks that have been removed from a browser source:

python3 scripts/brain.py sync chrome
python3 scripts/brain.py sources              # see connected sources and sync status

### Feedback

python3 scripts/brain.py feedback "your message"
python3 scripts/brain.py feedback --bug "something broke"
python3 scripts/brain.py feedback --idea "wouldn't it be cool if..."
python3 scripts/brain.py debug                # system info for bug reports

### Config

All data is stored in ~/.link-brain/:

brain.db (SQLite database)
graph.html (knowledge graph output)
console.html (GUI console)
collection-*.md and collection-*.html (exported collections)

Override the directory:

LINK_BRAIN_DIR=/tmp/test-brain python3 scripts/brain.py setup

### Tips

search understands time filters like "last week" and reading states like "unread" or "best rated"
Use --auto on every save unless you have a specific summary in mind. It's fast and surprisingly good.
review stats tells you how many links are overdue. Check it weekly.
gems is great for rediscovering old links you forgot you loved
Export a collection as HTML to share a reading list with someone
The graph gets more interesting after about 50 links. Before that, it's a bit lonely.
random is the "I'm bored" button
Combine scan with sync to keep browser bookmarks in check
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jakes420
- Version: 4.3.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T23:27:49.298Z
- Expires at: 2026-05-11T23:27:49.298Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/link-brain)
- [Send to Agent page](https://openagent3.xyz/skills/link-brain/agent)
- [JSON manifest](https://openagent3.xyz/skills/link-brain/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/link-brain/agent.md)
- [Download page](https://openagent3.xyz/downloads/link-brain)