iseeyou-sh
v0.1.9
Published
Hierarchical Project Brain for AI Coding Assistants
Downloads
936
Maintainers
Readme
iseeyou-sh
Your AI finally understands your project.
Persistent, hierarchical context for AI coding assistants. Parent projects share knowledge with children. Permissions control who sees what. Every session starts with understanding.
Install
npx iseeyou-sh initWhat it does
You work across related projects — a main product, an admin panel, a marketing site, docs. Your AI treats them as islands. iseeyou.sh connects them.
Startup
├── Main Product ← source of truth (write all)
├── Admin Panel ← inherits product knowledge (write all)
├── Marketing ← reads product context (read only)
└── Content ← inherits from marketing (read only)Run iseeyou-sh init in each project directory. Pick a parent. Set permissions. The tool scans your existing .md files and builds a project model.
From then on, a Claude Code hook injects the project's context — including inherited parent knowledge — before every prompt. No re-explaining. No context loss between sessions.
Commands
| Command | Description |
|---------|-------------|
| iseeyou-sh init | Set up a project (workspace, parent, permissions, context scan) |
| iseeyou-sh login | Authenticate with Supabase |
| iseeyou-sh link | Link to an existing project from .uberclaude file |
| iseeyou-sh tree | Print project hierarchy with permissions |
| iseeyou-sh status | Show task state + permissions |
| iseeyou-sh log | Browse the decision ledger |
| iseeyou-sh permissions | View or update permissions |
| iseeyou-sh model | Browse or add model entries |
How it works
- Init scans your project for
.mdfiles,TODO.md, and existing context - Supabase stores the project model, decisions, permissions, and task state
- Claude Code hooks inject context before every prompt
- MCP server provides 8 tools for Claude to read/write project knowledge
- Permissions control what child projects can see from parents
Requirements
- Node.js 20+
- Local or hosted Supabase instance
- Claude Code (for hooks + MCP integration)
Links
License
MIT
