Skip to main content

​
Setup

Run the CLI tool in your project directory:
This walks you through authentication, rule selection, and hook installation. Once complete, every Claude Code session in this project will have access to your rules.

​
What happens during setup

​
1. Authentication

If you’re not logged in, the CLI prompts for your email and sends a one-time password (OTP). After verification, your credentials are stored locally at ~/.config/rippletide/config.json.

​
2. Repository scan

The CLI scans your project to detect:
  • Tech stacks — TypeScript, Python, Rust, Go, Java, Ruby, and more
  • Existing CLAUDE.md — if present, existing rules are parsed and checked for contradictions
  • Project structure — source file count, test file count, MCP tools in .mcp.json

​
3. Rule generation

Based on your existing Claude Code sessions and CLAUDE.md, Rippletide generates rule candidates. Rules come from three sources:
  • Inferred — extracted from your past Claude Code sessions via the Context Graph
  • Generic — best practices for your detected tech stack
  • Default — general coding conventions

​
4. Rule selection

An interactive multi-select prompt lets you pick which rules to adopt. You can also type custom rules when prompted:
Selected rules are saved to the Rippletide backend and locally to .rippletide/selected-rules.md.

​
5. Hook installation

The CLI installs Claude Code hooks into your project:
After installation, Claude Code launches automatically with the hooks active.

​
Logout

To remove stored credentials:

​
Read-only mode

To connect without write access to the rule set (useful for team members who should follow but not modify conventions):
See Team Governance for details.

​
Data privacy

Rippletide only relies on the context available inside your local Claude Code workflow to identify reusable engineering rules:
  • the current Claude Code chat session for the active project
  • your CLAUDE.md
Your codebase is analyzed through your own local Claude Code environment, not centrally ingested. Rippletide only stores the extracted rules and conventions, not project content or unrelated session context.