# Linkshelf — `/links`

A personal link curation app. Save URLs you want to revisit, learn from, or share — organized by category and tagged for easy filtering.

## Files

- `index.html` — single-file web app (HTML/CSS/JS). No build step, no dependencies, opens directly in browser.
- `links.json` — the data store. All links and categories live here.
- `CLAUDE.md` — this file.

## Data structure (`links.json`)

```json
{
  "categories": ["Learning", "Tools", "Articles", "Sharing", "Design", "Dev"],
  "links": [
    {
      "id": "lnk001",
      "url": "https://example.com",
      "title": "Human-readable title",
      "description": "Optional note",
      "category": "Learning",
      "tags": ["AI", "learning"],
      "added": "2026-06-08T05:55:00.000Z"
    }
  ]
}
```

## How to add links

**Via the app:** Open `index.html`, click **+ Add Link**, fill in URL, title, category, tags.

**Via Claude (this MCP server):** Read `links/links.json`, append to the `links` array, write it back. Use a short unique `id` (e.g. `lnk002`), ISO timestamp for `added`, and match the category to one of the existing entries in `categories`. If a new category is needed, add it to the `categories` array too.

## Tag conventions

- Lowercase preferred, but mixed case is fine (the UI displays as-is)
- Use existing tags when possible for consistent filtering
- Common tags in use: `AI`, `learning`

## Notes

- The app reads/writes `links.json` through the Anthropic API + this MCP server at runtime
- Links are displayed newest-first
- No build process — edit `index.html` directly for UI changes