Little Steve Content Inbox

# Little Steve Content Inbox

A lightweight content archiving and review tool for IM workflows. Archive links, notes, and images sent in chat, manage their read status, and browse with pagination.

## Data Files

- `skills/little-steve-content-inbox/data/items.json`
- `skills/little-steve-content-inbox/data/view-state.json`

## Agent Command Conventions

1. Add link
```bash
bash {baseDir}/scripts/inbox.sh add --type link --title "Article title" --url "https://example.com/article" --tags "tech,ai"
```

2. Add note
```bash
bash {baseDir}/scripts/inbox.sh add --type note --title "Quick thought" --content "Some text content to save"
```

3. Add image
```bash
bash {baseDir}/scripts/inbox.sh add --type image --title "Screenshot" --media-path "/path/to/image.png"
```

4. List items (default: all, 10 per page)
```bash
bash {baseDir}/scripts/inbox.sh list --status all
bash {baseDir}/scripts/inbox.sh list --status unread
bash {baseDir}/scripts/inbox.sh list --status read
bash {baseDir}/scripts/inbox.sh list --status starred
```

5. Next page
```bash
bash {baseDir}/scripts/inbox.sh more
```

6. View item detail
```bash
bash {baseDir}/scripts/inbox.sh view --id <id>
```

7. Update status
```bash
bash {baseDir}/scripts/inbox.sh status --id <id> --status read
bash {baseDir}/scripts/inbox.sh status --id <id> --status starred
bash {baseDir}/scripts/inbox.sh status --id <id> --status unread
```

8. Delete item
```bash
bash {baseDir}/scripts/inbox.sh delete --id <id>
```

## Content Types

- `link` — web URL (article, tweet, page)
- `note` — plain text
- `image` — local image file
- `video` — (reserved for future use)

## Status Enum

- `unread` — new, not yet reviewed
- `read` — reviewed
- `starred` — bookmarked / favorited

## IM Output Format

- List: newest first, 10 items per page
- Per item: `[status][type] #ID title` (compact, no URL/path in list)
- Footer: `-- more: N total, showing X-Y --` or `-- end: N total --`
- Full URL/path only shown in detail view (`view --id`)

## Im...

# Little Steve Content Inbox

You know how it goes. You're scrolling through Twitter, a newsletter, a Reddit thread — and you find something worth reading. But not right now. So you forward it to yourself on Telegram. Then you find another one. And another.

Three weeks later, your chat history is a graveyard of links. Hundreds of them. You scroll past them every day, meaning to get back to them, never quite doing it. The good stuff is buried. The motivation is gone.

**Little Steve Content Inbox** is built for exactly this problem.

It's not a read-later app. It's not a bookmark manager. It's a lightweight inbox that lives inside your chat, so saving something is as natural as sending a message — and so is coming back to it.

Save links, notes, and images directly in conversation. Browse by status. Star the ones worth keeping. Get gently nudged to clear your backlog. The content you actually care about, organized and within reach — not silently rotting in a scroll.

## Key Capabilities

- Archive multiple content types: links, notes, images (video reserved)
- Status management: `unread` / `read` / `starred`
- Paginated browsing: 10 items per page with "more" for next page
- View full details by ID
- Delete items by ID
- Auto-detect content type from input
- Source domain extraction for links

## Dependency

- `jq`

macOS:
```bash
brew install jq
```

## Common Commands

```bash
# Add a link
bash scripts/inbox.sh add --type link --title "Interesting article" --url "https://example.com/article" --tags "tech"

# Add a note
bash scripts/inbox.sh add --type note --title "Quick thought" --content "Something to remember"

# Add an image
bash scripts/inbox.sh add --type image --title "Screenshot" --media-path "/path/to/image.png"

# List all (newest first, 10 per page)
bash scripts/inbox.sh list --status all

# List unread only
bash scripts/inbox.sh list --status unread

# Next page
bash scripts/inbox.sh more

# View detail
bash scripts/inbox.sh view --id 1

# Mark as read...