Procrast

procrast-cli

A Rust CLI and TUI for browsing your Procrast ideas. Includes a Claude Code plugin so Claude can search and read your ideas directly in conversation.

Prerequisites

• A Procrast account

Install the CLI

Quick install (recommended)

curl -sSL https://procrastination-station-xwi7hrqi.on-forge.com/install | sh

Detects your platform automatically and installs to ~/.local/bin/.

Build from source

Requires Rust:

cargo install --git https://github.com/yelsed/procrast-cli

Authenticate

procrast login

You'll be prompted for your email and password. The auth token is stored in your OS keyring (macOS Keychain, Linux secret-service, Windows Credential Manager).

CLI Usage

# List your ideas
procrast list
procrast list --limit 10 --hide-done
procrast list --json

# Show a single idea (full UUID or prefix)
procrast show abc123
procrast show abc123 --markdown
procrast show abc123 --json

# Search ideas
procrast search "my query"
procrast search "my query" --json

# Export an idea as a markdown file
procrast export abc123
procrast export abc123 --output my-idea.md

# Log out
procrast logout

TUI

Launch the interactive terminal UI:

procrast
# or
procrast tui

Keybindings:

Key	Action
j / Down	Next item
k / Up	Previous item
Enter	View idea details
/	Search
y	Copy as markdown (in detail view)
r	Retry connection
l	Re-login (when offline)
q	Quit / Back

The TUI works offline using a local SQLite cache.

Claude Code Plugin

The plugin lets Claude browse, search, and read your Procrast ideas directly in conversation.

Install

# Add the marketplace (one-time)
claude plugin marketplace add yelsed/procrast-cli

# Install the plugin
claude plugin install procrast

Restart Claude Code after installing. The plugin will automatically download the CLI binary on first use — no Rust or build tools required.

What it provides

Tools (Claude can call these):

Tool	Description
list_ideas	List ideas with titles, UUIDs, priorities
show_idea	Show full details of an idea by UUID
search_ideas	Full-text search across ideas
export_idea	Get an idea as formatted markdown
check_auth	Check if authenticated

Resources — Ideas are also available as MCP resources at procrast://ideas/{uuid}, so Claude can read them like files.

Uninstall

claude plugin uninstall procrast
claude plugin marketplace remove procrast

Configuration

The CLI uses the Procrast API at https://procrastination-station-xwi7hrqi.on-forge.com/api by default. To override:

# Via environment variable
export PROCRAST_API_URL=https://your-server.com/api

# Or via config file at ~/.config/procrast-cli/config.toml
api_url = "https://your-server.com/api"

License

MIT