Archivebox
Apps & AutomationarchiveboxArchivebox is an Agent Skill for apps & automation published in the ArchiveBox/ArchiveBox repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use this when working on the ArchiveBox app, CLI, server, Docker image, Admin UI, REST API, data dirs, crawls, snapshots, and release/deploy scripts.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/ArchiveBox/ArchiveBox/blob/HEAD/skills/archivebox/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/archivebox, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
ArchiveBox
Purpose
ArchiveBox is the full self-hosted web archiving app. Use this skill for collection operations, app code, Docker, Admin UI, API, and release work.
Shared Rules
- Keep this repo on branch
dev. - Use
uvanduv runfor Python commands. - Do not use system
python, direct.venv/bin/python, orpipcommands. - Use existing ArchiveBox CLI/API/UI/runner paths for setup and side effects.
- Do not mock, monkeypatch, fake, simulate, skip, xfail, or weaken tests.
- Verify behavior with real commands, real data dirs, real DB rows, real hooks, real browsers, and real filesystem outputs.
- Read
README.mdfor the full setup, CLI, Docker, API, and release surface.
Development Setup
uv sync --dev --all-extras
mkdir -p data
cd data
uv run --project .. archivebox init --install
User-Facing Setup
Recommended CLI install:
uv tool install archivebox
mkdir -p ~/archivebox/data
cd ~/archivebox/data
archivebox init --install
archivebox add 'https://example.com'
archivebox server 0.0.0.0:8000
Alternative install methods:
- Docker Compose / Docker
- Homebrew
- Debian package
- pip
Basic Usage
Run from inside an initialized data dir:
archivebox version
archivebox status
archivebox install
archivebox add 'https://example.com'
archivebox add --extract=title,screenshot,pdf 'https://example.com'
archivebox list --json --with-headers
archivebox search 'example'
archivebox update --filter-type=domain example.com
archivebox remove --filter-type=exact 'https://example.com'
archivebox run
Verification
uv run pytest archivebox/tests/test_cli_add.py -q
uv run prek run --all-files
Use the full release/deploy loop only when requested:
./bin/release_dev_stack.sh