Skip to main content
skill CX Codex

browsing-history — Claude Code skill for browsing history

Search browsing history by time, device, domain, or keywords. Group results and print them or save them as Markdown or JSON.

MIT 188 installs ★ 414 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add glebis/claude-skills --skill browsing-history -a claude-code
Open on GitHub

What browsing-history does

The skill runs browsing_query.py against the database at ~/data/browsing.db. It understands time queries such as “yesterday,” “last week,” and “last N days”; keyword searches match page titles and URLs. Add device or domain filters, set a result limit, or group entries by domain.

Results are printed as Markdown by default. Use --format json for JSON output and --output to save a file, including one in an Obsidian vault. Category grouping uses --categorize, which calls Claude 3.5 Haiku through the llm CLI. The database must be available at ~/data/browsing.db, or the history query cannot run. Repeated visits to the same URL on a given day are deduplicated.

What it helps with

  • find pages read yesterday on an iPhone
  • filter browsing history by domain and date
  • group visited pages by category
  • save history to Obsidian as Markdown or JSON

Example prompts for the agent

  • Find the articles I read yesterday on my iPhone.
  • Show last week's browsing history, grouped by domain.
  • Save last week's history to Obsidian and group the pages by category.

How to install browsing-history

1Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill browsing-history -a claude-code

2Manually: put the files in place

~/.claude/skills/browsing-history/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/browsing-history/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about browsing-history

How do I install browsing-history in Claude Code?

Run npx skills add glebis/claude-skills --skill browsing-history -a claude-code. The skill file is at ~/.claude/skills/browsing-history/SKILL.md.

What does browsing-history do?

It searches browser history by date, device, domain, and words in page titles or URLs. Results can be printed or saved as Markdown or JSON.

What does category classification require?

Category classification uses Claude 3.5 Haiku through the llm CLI. Add --categorize to the query.

Source text

SKILL.md · MIT
---
name: browsing-history
description: Query browsing history from all synced devices (iPhone, Mac, iPad, desktop). Supports natural language queries for filtering by date, device, domain, and keywords. Uses LLM classification for content categories. Can output to stdout or save as markdown/JSON to Obsidian vault.
---

# Browsing History Skill

Query browsing history from all synced devices with natural language.

## When to Use

Use this skill when the user asks about:
- Articles/pages they read (yesterday, last week, etc.)
- Browsing history from specific devices (iPhone, iPad, desktop)
- Finding pages by topic, domain, or keyword
- Exporting browsing history to files
- Grouping history by category or domain

## Database

Location: `~/data/browsing.db`

Synced devices: iPhone, iPad, Mac, desktop, Android

### Timestamps
- **visit_time**: Actual visit timestamp from Chrome (100% coverage for all devices)
- **first_seen**: Import timestamp (fallback when visit_time unavailable)

The skill uses `COALESCE(visit_time, first_seen)` for accurate time-based queries.

## Usage

```bash
python3 ~/.claude/skills/browsing-history/browsing_query.py "<query>" [options]
```

### Options

| Option | Description | Example |
|--------|-------------|---------|
| `--device` | Filter by device | `--device iPhone` |
| `--days` | Number of days back | `--days 7` |
| `--domain` | Filter by domain | `--domain medium.com` |
| `--limit` | Max results | `--limit 50` |
| `--format` | Output format | `--format json` |
| `--output` | Save to file | `--output history.md` |
| `--group-by` | Group results | `--group-by domain` or `--group-by category` |
| `--categorize` | Use LLM to categorize | `--categorize` |

### Example Queries

**Basic queries:**
```bash
# Yesterday's browsing history
python3 ~/.claude/skills/browsing-history/browsing_query.py "yesterday"

# Articles from iPhone yesterday
python3 ~/.claude/skills/browsing-history/browsing_query.py "yesterday" --device iPhone

# Last week's history grouped by domain
python3 ~/.claude/skills/browsing-history/browsing_query.py "last week" --group-by domain

# Find articles about economics
python3 ~/.claude/skills/browsing-history/browsing_query.py "economics" --days 7
```

**Save to Obsidian:**
```bash
# Save yesterday's history as markdown
python3 ~/.claude/skills/browsing-history/browsing_query.py "yesterday" \
  --output ~/Research/vault/browsing-2025-11-27.md

# Save with LLM categorization
python3 ~/.claude/skills/browsing-history/browsing_query.py "yesterday" \
  --categorize --group-by category \
  --output ~/Research/vault/browsing-categorized.md

# Save as JSON
python3 ~/.claude/skills/browsing-history/browsing_query.py "last week" \
  --format json --output ~/Research/vault/history.json
```

**Device-specific:**
```bash
# iPhone tabs
python3 ~/.claude/skills/browsing-history/browsing_query.py "yesterday" --device iPhone

# Desktop history
python3 ~/.claude/skills/browsing-history/browsing_query.py "today" --device desktop

# All mobile devices
python3 ~/.claude/skills/browsing-history/browsing_query.py "yesterday" --device mobile
```

**Search and filter:**
```bash
# Sites starting with "joy"
python3 ~/.claude/skills/browsing-history/browsing_query.py "joy" --days 7

# Medium.com articles
python3 ~/.claude/skills/browsing-history/browsing_query.py "last month" --domain medium.com
```

## Natural Language Patterns

The script recognizes:

| Pattern | Interpretation |
|---------|----------------|
| `yesterday` | Previous day |
| `today` | Current day |
| `last week` | Past 7 days |
| `last month` | Past 30 days |
| `last N days` | Past N days |

Keywords are searched in URL and title.

## Output Formats

### Markdown (default)
```markdown
# Browsing History: yesterday

*47 unique URLs from 2025-11-27*

## 2025-11-27

- [Article Title](https://example.com/article) - iPhone - 14:32
- [Another Page](https://another.com/page) - desktop - 16:45
```

### Markdown with categories (--categorize --group-by category)
```markdown
# Browsing History: yesterday

## News & Current Events
- [Breaking: Something Happened](https://news.com/...) - iPhone

## Technology & Programming
- [How to Build APIs](https://dev.to/...) - desktop

## Research & Learning
- [Academic Paper on AI](https://arxiv.org/...) - Mac
```

### JSON (--format json)
```json
{
  "query": "yesterday",
  "date_range": "2025-11-27",
  "total": 47,
  "results": [
    {"url": "...", "title": "...", "device": "iPhone", "time": "14:32", "category": "News"}
  ]
}
```

## Workflow Examples

**User: "Show me articles I read yesterday on my phone"**
```bash
python3 ~/.claude/skills/browsing-history/browsing_query.py "yesterday" --device iPhone
```

**User: "Save my browsing history from last week to Obsidian, grouped by category"**
```bash
python3 ~/.claude/skills/browsing-history/browsing_query.py "last week" \
  --categorize --group-by category \
  --output ~/Research/vault/browsing-week.md
```

**User: "Help me find that article about economics I read on my computer"**
```bash
python3 ~/.claude/skills/browsing-history/browsing_query.py "economics" \
  --device desktop --days 7
```

**User: "Sites that start with 'joy' from last week"**
```bash
python3 ~/.claude/skills/browsing-history/browsing_query.py "joy" --days 7
```

## Notes

- URLs are deduplicated per day (same URL on same day = one entry)
- **visit_time**: Actual visit timestamps from Chrome history
  - Desktop: 100% coverage (from Chrome SQLite `last_visit_time`)
  - Mobile: 100% coverage (extracted from Chrome Sync LevelDB)
- **first_seen**: Fallback import timestamp (~15min resolution)
- LLM categorization uses Claude 3.5 Haiku via `llm` CLI

© glebis · MIT · glebis/claude-skills

Similar skills

All skills for Browser and scraping →

From the same set51

The whole set →

Project sponsors

Companies that keep this analytics open