agentmark

name	agentmark
description	Use when the user mentions bookmarks, saved pages, or wants to save, search, tag, or manage web content via the `agentmark` CLI

AgentMark is the user's bookmarking system. When the user says "bookmarks", "saved pages", "what did I save", or anything about their bookmarks, they mean AgentMark. Always use the agentmark CLI commands below to find, save, and manage bookmarks.

- The `agentmark` CLI must be installed and on PATH - Run `agentmark init` if `~/.agentmark/config.toml` does not exist

When to Use This Skill

Activate when the user mentions:

• Saving a URL or web page for later
• Searching saved bookmarks or content
• Managing bookmarks (tagging, organizing, triaging)
• Reading or referencing previously saved articles
• Asking "what did I bookmark", "my bookmarks", "last saved", etc.

Bootstrap

Verify agentmark is on PATH: command -v agentmark >/dev/null 2>&1

If not found: curl -sSL https://raw.githubusercontent.com/codesoda/agentmark/main/install.sh | bash

Configuration

Config lives at ~/.agentmark/config.toml. Key settings: default_agent (claude/codex), storage_path (default: ~/agentmark), system_prompt (custom enrichment prompt), enrichment.enabled (default: true). Index DB at ~/.agentmark/index.db.

CLI Commands

agentmark init — interactive setup for agent choice and storage path.

agentmark save URL — save a URL. Flags: --tags TAGS (comma-separated), --collection NAME, --note TEXT, --action TEXT, --no-enrich.

agentmark list — list bookmarks. Flags: --collection NAME, --tag TAG, --state STATE (inbox/processed/archived), --limit N (default: 20).

agentmark show ID — show bookmark details. Flag: --full for extracted article content.

agentmark search QUERY — full-text search. Flags: --collection NAME, --limit N.

agentmark tag ID TAGS... — add tags. Flag: --remove to remove instead.

agentmark collections — list all collections with counts.

agentmark open ID — open bookmark URL in default browser.

agentmark reprocess ID — re-extract and re-enrich. Flag: --all for all bookmarks.

Bookmark Fields

Key fields: user_tags, suggested_tags, collections, note, state (inbox/processed/archived), capture_source (cli/chrome_extension), content_status (pending/extracted/failed), summary_status (pending/done/failed), content_hash.

Bundle Structure

Each bookmark is stored as a content bundle on disk:

<storage_path>/<YYYY>/<MM>/<DD>/<slug>-<id>/

Contains: bookmark.md (metadata + summary), article.md (extracted content), metadata.json, source.html, events.jsonl.

To read bookmark content, read bookmark.md for metadata/summary or article.md for the full article. Use agentmark show ID to find the bundle path.

Extending with system_prompt

Set system_prompt in config.toml to customize enrichment:

system_prompt = """
Focus on technical depth. Always include code examples in summaries.
"""