This README is the one indexed from the repository at its latest ref, not from the tag for this version.

Scry

Create and navigate date-prefixed directories for AI coding agents. Inspired by Toby Lütke's try.

Installation

Download the latest binary from Releases:

# macOS (Apple Silicon)
curl -L https://github.com/stephendolan/scry/releases/latest/download/scry-macos-arm64.tar.gz | tar xz
sudo mv scry /usr/local/bin/

# Linux
curl -L https://github.com/stephendolan/scry/releases/latest/download/scry-linux-x86_64.tar.gz | tar xz
sudo mv scry /usr/local/bin/

Or build from source (requires Crystal 1.18+):

git clone https://github.com/stephendolan/scry.git
cd scry
shards build --release
sudo mv bin/scry /usr/local/bin/

Add to your ~/.zshrc or ~/.bashrc:

eval "$(scry init)"

Usage

scry                      # Browse existing directories
scry metrics              # Jump to matching directory or filter
scry order-daycare-lunch  # Create new directory if no match

Navigation:

• ↑/↓ or Ctrl-K/Ctrl-J or Ctrl-P/Ctrl-N - Move cursor
• Enter - Select directory or create new
• Ctrl-D - Delete selected directory
• ESC/Ctrl-C - Exit
• Type to filter (fuzzy matching)

Templates

Bootstrap new scry directories with predefined files.

Setup: Create template directories in ~/.config/scry/templates/:

mkdir -p ~/.config/scry/templates/default
echo "# Instructions for Claude" > ~/.config/scry/templates/default/CLAUDE.md
echo "*.log" > ~/.config/scry/templates/default/.gitignore

Usage:

scry templates                          # List available templates
scry "ACME audit"                       # Prompts to pick a template
scry "security-review" --template audit # Apply audit template, skip the picker

When creating a new directory, scry shows an interactive template picker. If a default template exists it is preselected, so pressing Enter accepts it. Pass --template NAME to skip the picker and apply a specific template. All files from the chosen template directory are copied into the new scry directory.

Harnesses

The command launched after cd is the harness. Configure named harnesses and switch between them per invocation:

scry --harness codex "spike an idea"   # Launch the "codex" harness

See Configuration for defining harnesses.

Cleanup

Remove old directories by age or date:

scry cleanup 30              # Delete directories older than 30 days
scry cleanup 2024-01-01      # Delete directories before this date
scry cleanup                 # Interactive prompt

Shows preview with directory names, age, size, and file count before deletion.

Configuration

Optional configuration via ~/.config/scry/config.json or environment variables:

{
  "path": "~/scries",
  "default_harness": "claude",
  "harnesses": {
    "claude": "claude --dangerously-skip-permissions",
    "codex": "codex"
  },
  "continue_flag": "--continue"
}

• default_harness — name of the harness launched when --harness is omitted.
• harnesses — named commands selectable with --harness NAME.
• agent — legacy single-command harness; still honored when no harnesses map is configured.

Environment variables override config file settings:

export SCRY_PATH=~/experiments  # Custom directory location
export SCRY_HARNESS=codex       # Launch a configured harness by name
export SCRY_AGENT=opencode      # Raw harness command (legacy override)

License

MIT