First run tutorial¶

This tutorial uses a realistic test command and shows the full loop: record, inspect, search, export, rerun, and clean.

Create a sample command¶

From any project directory, run:

carrier run bash -c 'echo "build started"; echo "warning: example" >&2; sleep 1; exit 1'

The command exits with 1, and carrier exits with 1 too.

Inspect latest run¶

carrier last

Output includes:

ID:       42
Status:   failed
Command:  bash -c 'echo "build started"; echo "warning: example" >&2; sleep 1; exit 1'
CWD:      /home/alice/project
Exit:     1
Duration: 1s

Show output¶

carrier show 42

For carrier run, stdout and stderr are shown separately.

Tail output¶

Tail both streams with labels:

carrier tail 42

Tail one stream:

carrier tail 42 --stream stdout
carrier tail 42 --stream stderr

Search logs¶

carrier search "warning"

Search checks command text, cwd, and stored output logs.

Export report¶

carrier export 42 > failed-run.md

The report is Markdown, with metadata plus output blocks.

Rerun from original directory¶

carrier rerun 42

Rerun creates a new run record.

If you want to edit the command first:

carrier rerun 42 --edit

Try JSON output¶

carrier show 42 --json
carrier last --json
carrier running --json

Use JSON when integrating with scripts.

Clean when done¶

Preview:

carrier clean --older-than 30d --dry-run

Delete:

carrier clean --older-than 30d --yes