Getting Started

Install Waves, configure your first project, and learn the daily workflow that keeps your AI agent productive across sessions.

Get Started

Install in 60 Seconds — Free Forever

Option 1: Homebrew (Recommended)

brew tap exovian-developments/waves

brew install waves

# Initialize in your project

cd your-project

waves init

# Then in Claude Code:

/waves:project-init

Option 2: Claude Desktop Plugin

Download waves.plugin from GitHub Releases and double-click to install in Claude Desktop. The plugin auto-loads your project context on session start.

1Download waves.plugin from GitHub Releases

2Double-click to install in Claude Desktop

3Open your project — Waves auto-loads context

4Run /waves:project-init to configure your project

Option 3: Manual Installation

git clone https://github.com/exovian-developments/waves.git

# Copy commands to your project

mkdir -p your-project/.claude/commands

cp -r waves/.claude/commands/* your-project/.claude/commands/

# Copy schemas to your project

mkdir -p your-project/ai_files/schemas

cp waves/schemas/*.json your-project/ai_files/schemas/

After Installation

Run these two commands to get your project fully configured:

/waves:project-init Sets up your preferences and project context

/waves:manifest-create Analyzes your codebase and creates the project manifest

From this point on, every AI agent that reads your project will understand its architecture, conventions, and history.

Daily Workflow

What a Typical Day Looks Like

Morning

Pick up where you left off

/waves:logbook-update FEAT-42.json

The AI reads your logbook, shows what was completed yesterday, what's blocked, and what's next. No context re-establishment needed.

Code

Implement with guardrails

/waves:objectives-implement FEAT-42.json

The agent implements the next objective following your project rules. The code auditor checks compliance automatically. Code passes review on the first try.

End of day

Document progress

/waves:logbook-update FEAT-42.json

Saves progress, decisions, and findings. History auto-compacts when entries exceed 20. Tomorrow's session starts with full context.

Done

Generate resolution

/waves:resolution-create FEAT-42

Auto-generates a ticket resolution document from your logbook. What was done, why, and how — ready for your team or your future self.

Previous The Team Next Adoption Patterns