CLI Commands

Complete reference for all Rapide CLI commands.

Entry Logging

rapide [entry]

The default command — logs a new entry.

rapide "• Buy coffee"
rapide "work | O Meeting @ 2pm!"

See Syntax & Bullets for the full entry format.

---

Setup

rapide init

Interactive setup wizard. Prompts for your name, collections, and optional Git sync. Seeds the journal with example entries.

rapide init

WARNING

If your journal already has entries, init will ask for confirmation before adding seed entries.

---

Viewing

rapide list

List journal entries with sorting and filtering.

rapide list                # Last 30 days
rapide list today          # Today only
rapide list 7d             # Last 7 days
rapide list work           # Filter by collection

Flags:

Flag	Short	Description
--time	-t	Time filter: today, 3d, 7d
--filter	-f	Filter by margin key
--bullet	-b	Filter by bullet type: -, O, •, x
--priority	-p	Show only priority entries
--all	-a	Include auto-hidden completed tasks

rapide unfinished

List all non-completed tasks (bullet •).

rapide unfinished

rapide collections

Show all margin keys with entry counts.

rapide collections

rapide search

Search all entries by keyword or ID.

rapide search "deployment"
rapide search a1b2

---

Actions

rapide done <id>

Mark a task as completed (x).

rapide done a1b2

rapide migrate <id>

Move a task to today and mark the original as migrated (>).

rapide migrate a1b2

rapide edit <id> <text>

Update the content of an existing entry.

rapide edit a1b2 "Updated task description"

rapide pin <id>

Toggle pin status on an entry. Pinned items sort to the top.

rapide pin a1b2

rapide delete <id>

Permanently remove an entry.

rapide delete a1b2

---

Journal Management

rapide trim

Archive or delete old entries with a guided confirmation.

rapide trim --before 2025-01-01

rapide sync

Sync your journal with a private Git repository.

rapide sync                    # Pull and push
rapide sync --setup <git-url>  # Link a repo
rapide sync --autosync true    # Enable auto-sync

See Git Sync for full details.

---

Interactive

rapide tui

Open the interactive Terminal User Interface.

rapide tui

See TUI Interface for hotkeys and features.

---

Utility

rapide version

Print the current version.

rapide version

rapide completion

Generate shell autocompletion scripts.

source <(rapide completion zsh)    # Zsh
source <(rapide completion bash)   # Bash
rapide completion fish | source    # Fish