Scry

Create and navigate date-prefixed directories for AI coding agents.

Installation

From releases

Download the latest binary for your platform 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/

# macOS (Intel)
curl -L https://github.com/stephendolan/scry/releases/latest/download/scry-macos-x86_64.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/

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/

Setup

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

eval "$(scry init)"

This creates a shell function that wraps the binary. The CLI outputs shell commands (e.g., cd '/path' && claude) which the shell function evaluates in your current session.

Usage

scry                    # Browse and select from existing scries
scry redis              # Jump to matching scry or filter list
scry api-experiment     # Create new scry if no match exists

Keyboard shortcuts

Configuration

Defaults to Claude but supports any AI coding agent.

Config file

Create ~/.config/scry/config.json:

{
  "path": "~/scries",
  "agent": "claude",
  "instructions": "CLAUDE.md"
}

Environment variables

Environment variables override config file settings:

Examples

export SCRY_AGENT=aider           # Use with Aider
export SCRY_AGENT=codex           # Use with Codex
export SCRY_PATH=~/experiments    # Custom storage path

How it works

1. Creates date-prefixed directories: 2024-11-24-redis-experiment
2. Fuzzy search with smart scoring (recency, word boundaries, proximity)
3. Changes to selected directory and launches your AI agent
4. Seeds new directories with instructions file

Development

# Install dependencies
shards install

# Run tests
crystal spec -Dspec

# Run linter
./bin/ameba

# Check formatting
crystal tool format --check

# Build release binary
shards build --release --no-debug

License

MIT