The 5am CLI

Quick install

Install or upgrade the 5am CLI on macOS or Linux with a single command. The script detects your platform and architecture automatically.

# Install or upgrade the 5am CLI (macOS and Linux)
curl -fsSL https://cli.5am.app/cli/latest/install.sh | sh

Download

Every binary is stripped, statically linked (CGO_ENABLED=0), and ~14 MB. Verify each download against its .sha256 file.

Verify integrity

Each binary has a published .sha256 file alongside it. After downloading, confirm the hash matches:

curl -sS https://cli.5am.app/cli/latest/5am-darwin-arm64.sha256 | shasum -a 256 -c
# → 5am-darwin-arm64: OK

Full machine-readable manifest with sizes, hashes, and version metadata: manifest.json

Use it with an AI agent

The CLI ships with a companion SKILL.md that follows the Agent Skills open standard. Drop it into Claude Code, Gemini CLI, or any compatible tool, and the agent will recognize prompts like “upload these photos to a new album” and reach for the 5am binary on its own.

# Claude Code (personal — applies to all projects)
mkdir -p ~/.claude/skills/5am
curl -L https://cli.5am.app/cli/latest/SKILL.md -o ~/.claude/skills/5am/SKILL.md

# Or project-local (gets committed alongside your code)
mkdir -p .claude/skills/5am
curl -L https://cli.5am.app/cli/latest/SKILL.md -o .claude/skills/5am/SKILL.md

Download SKILL.md →

First steps

Mint a token in the web UI (Settings → CLI Access Tokens → Generate), then:

5am login                # paste the token at the prompt
5am whoami               # confirm
5am albums list
5am account --pretty

# Upload a directory recursively
5am media upload ./photos -r --include '*.jpg,*.mp4' --album <id> --concurrency 8

# Download an entire album
5am albums download <id> --output ./trip --concurrency 8

# Generate media from a prompt
5am media generate image --prompt "a cybernetic owl at dawn" --output owl.png

Example use cases

# The web workflow: run the companion, then open 5am.app/clip-maker
5am studio

# Or fully scripted: five 9:16 clips with subtitles → talk-clips/
5am media clips talk.mp4 --count 5 --brief "the product demo moments"

# Download the helper alongside the CLI
curl -L https://cli.5am.app/cli/latest/podcast_to_video.py -o podcast_to_video.py

# Waveform video (instant, no AI): cover art + waveform + synced captions
python3 podcast_to_video.py -i episode.wav --visualize \
  --cover cover.jpg -s episode.srt -a 9:16

# Or AI b-roll: Veo writes per-scene prompts from your transcript
python3 podcast_to_video.py -i episode.wav -s episode.srt -a 9:16 --clips 2

5am media upload ./footage/interview-4k.mov --album "Shoots"
5am media upload ./festival-master.mov --album "Masters" --part-concurrency 8

5am media upload ~/Pictures/2026 -r --include '*.jpg,*.heic,*.mp4' \
  --new-album "2026 Archive" --concurrency 8 --describe

# On the server: ingest a log into a queryable dataset, then serve
5am data ingest --dataset requests --schema requests.schema.json \
  --file /var/log/nginx/access.log --format combined
5am serve agent --name portfolio

What’s in the box

Examples on GitHub

The scripts above are downloadable individually, but digvan/5am-cli collects them with the pieces that don’t fit in a single file — a systemd installer that puts a server agent under supervision, a metrics sampler with its schema, ready-made schemas for nginx logs, and a full server-agent deployment guide. Apache-2.0, so copy and adapt freely.

• examples/install-agent.sh — writes and starts the systemd units so an agent survives reboots
• examples/sysmetrics.sh — one CPU/memory/disk sample per run, ready to ingest
• examples/podcast_to_video.py — the helper above, with its test suite
• SKILL.md — the agent reference, with install steps for Claude Code, Gemini CLI, and Codex

Browse the examples →Report an issue →