Documentation

Name: Ninho
Author: Ninho

Everything you need to know about Ninho.

Quick Start

Get Ninho running in under 2 minutes.

1. Install

curl -fsSL https://raw.githubusercontent.com/ninho-ai/ninho/main/install.sh | bash

2. Restart Claude Code

Close and reopen Claude Code to activate the plugin.

3. Verify

/ninho:status

You should see "No Ninho data found" initially. As you code, PRDs and learnings will accumulate automatically.

How It Works

Background Processing

Ninho uses Claude Code hooks to run in the background:

SessionStart - Injects PRD context when you start coding
Stop - Monitors for PRD-worthy content after each response
PreCompact - Captures context before memory compaction
SessionEnd - Extracts learnings when you exit

Signal Detection

Ninho detects patterns in your conversations:

Signal Type	Patterns
Requirements	"need to", "should have", "must support"
Decisions	"let's use", "decided on", "we'll go with"
Constraints	"must be", "cannot", "limited to"
Learnings	"no, don't", "actually", "remember:"

Directory Structure

~/.ninho/                    # Global (user-level)
├── daily/
│   ├── 2026-02-16.md       # Today's learnings
│   └── 2026-02-15.md       # Yesterday's learnings
└── ninho.log               # Debug log

your-project/.ninho/        # Project-level (git-trackable)
├── prds/
│   ├── auth-system.md      # Auto-generated PRD
│   └── api-integration.md
├── prompts/
│   └── 2026-02-16.md       # Captured prompts
└── pr-mappings.json        # Branch-to-PRD links

Commands

Ninho works automatically, but these commands are available for manual control:

/ninho:status

View PRDs, learnings, and stale items

/ninho:prd-list

List all PRDs with detailed summaries

/ninho:search <query>

Search across PRDs and prompts

/ninho:digest

Generate weekly summary

PRD Format

PRDs follow a consistent structure:

# Feature Name

## Overview
Brief description of the feature.

## Requirements
- [ ] Incomplete requirement
- [x] Completed requirement

## Decisions
| Date | Decision | Rationale |
|------|----------|-----------|
| 2026-02-15 | Use JWT | Stateless, scales horizontally |

## Constraints
- Technical or business constraints

## Open Questions
- Unanswered questions *(asked 2026-02-15)*

## Related Files
- `src/feature/file.ts`

## Session Log
### 2026-02-15
- What happened ([prompt](prompts/2026-02-15.md#L12))

Troubleshooting

Plugin not loading?

claude --debug

Look for "ninho" in the loaded plugins list.

Check logs

cat ~/.ninho/ninho.log | tail -20

Reinstall

rm -rf ~/.ninho-plugin && curl -fsSL https://raw.githubusercontent.com/ninho-ai/ninho/main/install.sh | bash