archivist

Files (1)

• SKILL.md

SKILL.md (first lines)

# Archivist 📁

Your personal librarian. Save anything — URLs, files, notes, screenshots — and Paw makes it searchable, tagged, and instantly retrievable.

## When to Use

✅ **USE this skill when:**

- "Save this article for later"
- Building a personal knowledge base
- Organizing research materials
- Archiving reference links
- Saving code snippets with context
- Creating a searchable bookmark library
- Capturing voice notes with transcription
- Organizing screenshots with descriptions
- Building a "second brain"

## When NOT to Use

❌ **DON'T use this skill when:**

- Full file backup/sync → use Time Machine, Backblaze, etc.
- Website mirroring → use wget, HTTrack
- Large-scale web scraping → use Scrapy, Apify
- Photo library management → use Photos, Lightroom
- Document version control → use Git, Dropbox versioning
- Collaborative wikis → use Notion, Obsidian Sync

## Setup

Install Archivist:

```bash
npm install -g @pawhub/archivist
```

Initialize your archive:

```bash
# Create archive database
archivist init

# Set storage location (default: ~/.archivist)
archivist config set storage-path ~/Documents/Archive

# Verify setup
archivist status
```

## Example Interactions

### Saving Content

**You:** Save this for later: https://example.com/great-article

**Paw:** *fetches and archives the page*

✅ **Saved:** "How to Build Better APIs"

**Captured:**
- Full HTML (for offline reading)
- Screenshot (visual reference)
- Extracted text (for search)
- Title: "How to Build Better APIs"
- Author: Jane Smith
- Published: 2026-01-15

**Auto-tags:** #api-design #programming #webdev

**Summary (AI-generated):**
> Article discusses REST vs GraphQL trade-offs, API versioning strategies, and authentication best practices. Includes code examples in Python and Node.js.

**Archive ID:** `arch_abc123`

Want to add custom tags or notes? Just say the word. 🐾

---

**You:** Add tags: must-read, reference, backend

**Paw:** *updates the entry*

✅ Tags updated:
- #api-design (auto)
- #programming (auto)
- #webdev (auto)
- #must-read (you)
- #reference (you)
- #backend (you)

Searchable immediately. Try: `archivist search "api design must-read"` 📚

---

**You:** Save this snippet:

```python
def retry_with_backoff(func, max_retries=3):
    for attempt in range(max_retries):
        try:
            return func()
        except Exception as e:
            if attempt == max_retries - 1:
                raise
            time.sleep(2 ** attempt)
```

**Paw:** *analyzes and archives the code*

✅ **Saved:** Code snippet

**Details:**
- Language: Python
- Type: Function definition
- Name: `retry_with_backoff`
- Lines: 9

**Auto-tags:** #python #error-handling #retry-logic

From Flexasaurusrex/OpenPaw, MIT.

More from Flexasaurusrex/OpenPaw