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: ↑/↓ move, Enter select, Ctrl-D delete, ESC exit, type to filter

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"                       # Creates directory with default template
scry "security-review" --template audit # Apply audit template instead

The default template is applied automatically when creating new directories. All files from the template directory are copied to the new scry directory.

Configuration

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

{
  "path": "~/scries",
  "agent": "claude"
}

Environment variables override config file settings:

export SCRY_PATH=~/experiments  # Custom directory location
export SCRY_AGENT=opencode      # Different AI agent command

License

MIT