Relay Pro

Story-Driven project context management for AI-assisted development.

The problem: AI agents lose context between sessions, hallucinate file paths, and repeat work already done.

The solution: A global CLI that gives any AI agent 100% accurate project context in one command.

relay info my-app
# → Outputs full BRIEF + SPEC + STORIES + DECISIONS + latest log
# → AI instantly knows everything about the project

Install

npm install -g relay-pro
relay init

relay init will interactively ask for your default project paths, then set up ~/.relay/.

Core Commands

relay init                          # First-time setup (interactive)
relay new <name> [options]          # Create a new project/company
relay info <name>                   # Show full context (fuzzy match supported)
relay list [--type=software] [--json]  # List all entities

relay new options

relay new my-app                              # software project (default)
relay new sm-consulting --type project \
  --company jwd --keywords smac,crm          # PM/consulting project
relay new acme-corp --type company            # company profile

Entity types:

• software — BRIEF + SPEC + STORIES + ROADMAP + DECISIONS (for code projects)
• project — BRIEF + DECISIONS (for PM/consulting work)
• company — _context.md (company background, auto-injected into related projects)

How It Works

Project Structure

Each project gets a relay/ folder:

my-app/
└── relay/
    ├── config.json    # prefix, type, company, keywords
    ├── brief.md       # background, goals, success metrics
    ├── spec.md        # tech stack, architecture
    ├── stories.md     # user stories (No Story, No Code)
    ├── roadmap.md     # milestones and status
    ├── decisions.md   # key decisions and rationale
    └── log/           # session logs (YYYY-MM-DD.md)

Company Context Injection

When you run relay info my-app and my-app is linked to a company, Relay automatically appends the company's _context.md. Your AI agent gets project + company context in one shot.

Fuzzy Matching

relay info bpk     # → finds best-practice-kit (via keyword)
relay info smac    # → finds sm-smac-impl (via keyword)

Workflow

# Start of session
relay info my-app          # → AI gets full context

# During development
# No Story, No Code: always add a story before writing code

# End of session
# Update relay/log/YYYY-MM-DD.md + relay/stories.md

Configuration

~/.relay/config.json — default paths for each entity type:

{
  "version": "3.1",
  "defaults": {
    "software": "~/projects",
    "project": "~/Documents/Projects",
    "company": "~/Documents/Areas"
  }
}

Philosophy

• No Story, No Code — every code change must have a corresponding Story
• Context is infrastructure — project context should be as reliable as version control
• AI-first design — structured for machine consumption, readable by humans

Made with ❤️ by Moozy Studio