Trellis

Trellis

All-in-one AI framework & toolkit for Claude Code & Cursor

Stars: 1991

Visit
 screenshot

Trellis is an all-in-one AI framework and toolkit designed for Claude Code, Cursor, and iFlow. It offers features such as auto-injection of required specs and workflows, auto-updated spec library, parallel sessions for running multiple agents simultaneously, team sync for sharing specs, and session persistence. Trellis helps users educate their AI, work on multiple features in parallel, define custom workflows, and provides a structured project environment with workflow guides, spec library, personal journal, task management, and utilities. The tool aims to enhance code review, introduce skill packs, integrate with broader tools, improve session continuity, and visualize progress for each agent.

README:

Trellis Logo

All-in-one AI framework & toolkit for Claude Code, Cursor & iFlow
Wild AI ships nothing.

npm version license stars Discord

Quick StartWhy TrellisUse CasesHow It WorksFAQ

Why Trellis?

Feature Problem Solved
Auto-Injection Required specs and workflows auto-inject into every conversation. Write once, apply forever
Auto-updated Spec Library Best practices live in auto-updated spec files. The more you use it, the better it gets
Parallel Sessions Run multiple agents in tandem - each in its own worktree
Team Sync Share specs across your team. One person's best practice benefits everyone
Session Persistence Work traces persist in your repo. AI remembers project context across sessions

Quick Start

# 1. Install globally
npm install -g @mindfoldhq/trellis@latest

# 2. Initialize in your project directory
trellis init -u your-name

# Or include iFlow CLI support
trellis init --iflow -u your-name

# 3. Start Claude Code and begin working

your-name becomes your identifier and creates a personal workspace at .trellis/workspace/your-name/

Trellis Initialization Example

Use Cases

Educating Your AI

Write your specs in Markdown. Trellis injects them into every AI session — no more repeating yourself.

Teaching AI - Teach Once, Apply Forever

Define your component guidelines, file structure rules, and patterns once. AI automatically applies them when creating new code — using TypeScript with Props interface, following PascalCase naming, building functional components with hooks.

Ship in Parallel

Spawn multiple Claude sessions in isolated worktrees with /trellis:parallel. Work on several features at once, merge when ready.

Parallel Work - Multiple features developing simultaneously

While coding, each worker runs in its own worktree (physically isolated directory), no blocking, no interference. Review and merge completed features while others are still in progress.

Custom Workflows

Define custom skills & commands that prepare Claude for specific tasks and contexts.

Workflows - Custom commands for instant context loading

Create commands like /trellis:before-frontend-dev that load component guidelines, check recent changes, pull in test patterns, and review shared hooks—all with a single slash.

How It Works

Project Structure

.trellis/
├── workflow.md              # Workflow guide (auto-injected on start)
├── worktree.yaml            # Multi-agent config (for /trellis:parallel)
├── spec/                    # Spec library
│   ├── frontend/            #   Frontend specs
│   ├── backend/             #   Backend specs
│   └── guides/              #   Decision & analysis frameworks
├── workspace/{name}/        # Personal journal
├── tasks/                   # Task management (progress tracking & more)
└── scripts/                 # Utilities

.claude/
├── settings.json            # Hook configuration
├── agents/                  # Agent definitions
│   ├── dispatch.md          #   Dispatch Agent (pure routing, doesn't read specs)
│   ├── implement.md         #   Implement Agent
│   ├── check.md             #   Check Agent
│   └── research.md          #   Research Agent
├── commands/                # Slash commands
└── hooks/                   # Hook scripts
    ├── session-start.py     #   Inject context on startup
    ├── inject-subagent-context.py  #   Inject specs to subagents
    └── ralph-loop.py               #   Quality control loop

Workflow Diagram

Trellis Workflow Diagram

Roadmap

  • [ ] Better Code Review — More thorough automated review workflow
  • [ ] Skill Packs — Pre-built workflow packs, plug and play
  • [ ] Broader Tool Support — Cursor, OpenCode, Codex integration
  • [ ] Stronger Session Continuity — Autosave session-wide history
  • [ ] Visual Parallel Sessions — Real-time progress for each agent

FAQ

Why Trellis instead of Skills?

Skills are optional — AI may skip them, leading to inconsistent quality. Trellis enforces specs via Hook injection: not "can use" but "always applied". This turns randomness into determinism, so quality doesn't degrade over time.

Do I write spec files manually or let AI create them?

Most of the time, AI handles it — just say "We use Zustand, no Redux" and it creates the spec file automatically. But when you have architectural insights AI can't figure out on its own, that's where you step in. Teaching AI your team's hard-won lessons — that's why you won't lose your job to AI.

How is this different from CLAUDE.md / AGENTS.md / .cursorrules?

Those are all-in-one files — AI reads everything every time. Trellis uses layered architecture with context compression: only loads relevant specs for current task. Engineering standards should be elegantly layered, not monolithic.

Will multiple people conflict?

No. Each person has their own space at .trellis/workspace/{name}/.

How does AI remember previous conversations?

Use /trellis:record-session at the end of each conversation. AI writes a session summary to .trellis/workspace/{name}/journal-N.md and indexes it in index.md. Next time you /trellis:start, AI automatically reads recent journals and git info to restore context. In theory, you could just submit your daily journal files as your work report 🤣.

Star History

Star History Chart

Community

FSL License • Made with care by Mindfold

Found Trellis useful? Please consider giving it a ⭐

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for Trellis

Similar Open Source Tools

For similar tasks

For similar jobs