{"id":43706036,"url":"https://github.com/mindfold-ai/Trellis","last_synced_at":"2026-02-15T00:01:27.169Z","repository":{"id":336151253,"uuid":"1142423471","full_name":"mindfold-ai/Trellis","owner":"mindfold-ai","description":"All-in-one AI framework \u0026 toolkit for Claude Code \u0026 Cursor","archived":false,"fork":false,"pushed_at":"2026-02-12T03:52:23.000Z","size":6299,"stargazers_count":2166,"open_issues_count":0,"forks_count":108,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-02-12T13:40:37.544Z","etag":null,"topics":["ai-agent","ai-coding","claude-code","cli","cursor","developer-tools","typescript","workflow"],"latest_commit_sha":null,"homepage":"https://trytrellis.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mindfold-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT","agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-26T11:49:10.000Z","updated_at":"2026-02-12T12:33:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mindfold-ai/Trellis","commit_stats":null,"previous_names":["mindfold-ai/trellis"],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/mindfold-ai/Trellis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindfold-ai%2FTrellis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindfold-ai%2FTrellis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindfold-ai%2FTrellis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindfold-ai%2FTrellis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mindfold-ai","download_url":"https://codeload.github.com/mindfold-ai/Trellis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindfold-ai%2FTrellis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29461365,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T22:42:09.113Z","status":"ssl_error","status_checked_at":"2026-02-14T22:42:05.053Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","ai-coding","claude-code","cli","cursor","developer-tools","typescript","workflow"],"created_at":"2026-02-05T06:00:17.296Z","updated_at":"2026-02-15T00:01:27.131Z","avatar_url":"https://github.com/mindfold-ai.png","language":"Python","readme":"\u003c!--\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/meme.png\" alt=\"AI Coding Problems Meme\" /\u003e\n\u003c/p\u003e--\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cpicture\u003e\n\u003csource srcset=\"assets/trellis.png\" media=\"(prefers-color-scheme: dark)\"\u003e\n\u003csource srcset=\"assets/trellis.png\" media=\"(prefers-color-scheme: light)\"\u003e\n\u003cimg src=\"assets/trellis.png\" alt=\"Trellis Logo\" width=\"500\" style=\"image-rendering: -webkit-optimize-contrast; image-rendering: crisp-edges;\"\u003e\n\u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cstrong\u003eAll-in-one AI framework \u0026 toolkit for Claude Code, Cursor, iFlow \u0026 Codex\u003c/strong\u003e\u003cbr/\u003e\n\u003csub\u003eWild AI ships nothing.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://www.npmjs.com/package/@mindfoldhq/trellis\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@mindfoldhq/trellis.svg?style=flat-square\u0026color=blue\" alt=\"npm version\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/mindfold-ai/Trellis/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-FSL-green.svg?style=flat-square\" alt=\"license\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/mindfold-ai/Trellis/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/mindfold-ai/Trellis?style=flat-square\u0026color=yellow\" alt=\"stars\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.com/invite/tWcCZ3aRHc\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord-Join-7289DA?style=flat-square\u0026logo=discord\u0026logoColor=white\" alt=\"Discord\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"#quick-start\"\u003eQuick Start\u003c/a\u003e •\n\u003ca href=\"#why-trellis\"\u003eWhy Trellis\u003c/a\u003e •\n\u003ca href=\"#use-cases\"\u003eUse Cases\u003c/a\u003e •\n\u003ca href=\"#how-it-works\"\u003eHow It Works\u003c/a\u003e •\n\u003ca href=\"#faq\"\u003eFAQ\u003c/a\u003e\n\u003c/p\u003e\n\n## Why Trellis?\n\n| Feature | Problem Solved |\n| --- | --- |\n| **Auto-Injection** | Required specs and workflows auto-inject into every conversation. Write once, apply forever |\n| **Auto-updated Spec Library** | Best practices live in auto-updated spec files. The more you use it, the better it gets |\n| **Parallel Sessions** | Run multiple agents in tandem - each in its own worktree |\n| **Team Sync** | Share specs across your team. One person's best practice benefits everyone |\n| **Session Persistence** | Work traces persist in your repo. AI remembers project context across sessions |\n\n## Quick Start\n\n```bash\n# 1. Install globally\nnpm install -g @mindfoldhq/trellis@latest\n\n# 2. Initialize in your project directory\ntrellis init -u your-name\n\n# Or include iFlow CLI support\ntrellis init --iflow -u your-name\n\n# Or include Codex skills support\ntrellis init --codex -u your-name\n\n# 3. Start Claude Code and begin working\n```\n\n\u003e `your-name` becomes your identifier and creates a personal workspace at `.trellis/workspace/your-name/`\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/info.png\" alt=\"Trellis Initialization Example\" /\u003e\n\u003c/p\u003e\n\n## Use Cases\n\n### Educating Your AI\n\nWrite your specs in Markdown. Trellis injects them into every AI session — no more repeating yourself.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/usecase1.png\" alt=\"Teaching AI - Teach Once, Apply Forever\" /\u003e\n\u003c/p\u003e\n\nDefine 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.\n\n### Ship in Parallel\n\nSpawn multiple Claude sessions in isolated worktrees with `/trellis:parallel`. Work on several features at once, merge when ready.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/usecase2.png\" alt=\"Parallel Work - Multiple features developing simultaneously\" /\u003e\n\u003c/p\u003e\n\nWhile 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.\n\n### Custom Workflows\n\nDefine custom skills \u0026 commands that prepare Claude for specific tasks and contexts.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/usecase3.png\" alt=\"Workflows - Custom commands for instant context loading\" /\u003e\n\u003c/p\u003e\n\nCreate 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.\n\n## How It Works\n\n### Project Structure\n\n```\n.trellis/\n├── workflow.md              # Workflow guide (auto-injected on start)\n├── worktree.yaml            # Multi-agent config (for /trellis:parallel)\n├── spec/                    # Spec library\n│   ├── frontend/            #   Frontend specs\n│   ├── backend/             #   Backend specs\n│   └── guides/              #   Decision \u0026 analysis frameworks\n├── workspace/{name}/        # Personal journal\n├── tasks/                   # Task management (progress tracking \u0026 more)\n└── scripts/                 # Utilities\n\n.claude/\n├── settings.json            # Hook configuration\n├── agents/                  # Agent definitions\n│   ├── dispatch.md          #   Dispatch Agent (pure routing, doesn't read specs)\n│   ├── implement.md         #   Implement Agent\n│   ├── check.md             #   Check Agent\n│   └── research.md          #   Research Agent\n├── commands/                # Slash commands\n└── hooks/                   # Hook scripts\n    ├── session-start.py     #   Inject context on startup\n    ├── inject-subagent-context.py  #   Inject specs to subagents\n    └── ralph-loop.py               #   Quality control loop\n\n```\n\n### Workflow Diagram\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/workflow.png\" alt=\"Trellis Workflow Diagram\" /\u003e\n\u003c/p\u003e\n\n## Roadmap\n\n- [ ] **Better Code Review** — More thorough automated review workflow\n- [ ] **Skill Packs** — Pre-built workflow packs, plug and play\n- [ ] **Broader Tool Support** — Cursor, OpenCode, Codex integration\n- [ ] **Stronger Session Continuity** — Autosave session-wide history\n- [ ] **Visual Parallel Sessions** — Real-time progress for each agent\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhy Trellis instead of Skills?\u003c/strong\u003e\u003c/summary\u003e\n\nSkills 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.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDo I write spec files manually or let AI create them?\u003c/strong\u003e\u003c/summary\u003e\n\nMost 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.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHow is this different from \u003ccode\u003eCLAUDE.md\u003c/code\u003e / \u003ccode\u003eAGENTS.md\u003c/code\u003e / \u003ccode\u003e.cursorrules\u003c/code\u003e?\u003c/strong\u003e\u003c/summary\u003e\n\nThose 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.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWill multiple people conflict?\u003c/strong\u003e\u003c/summary\u003e\n\nNo. Each person has their own space at `.trellis/workspace/{name}/`.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHow does AI remember previous conversations?\u003c/strong\u003e\u003c/summary\u003e\n\nUse `/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 🤣.\n\n\u003c/details\u003e\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=mindfold-ai/Trellis\u0026type=Date)](https://star-history.com/#mindfold-ai/Trellis\u0026Date)\n\n## Community\n\n- [Discord](https://discord.com/invite/tWcCZ3aRHc) — Join the conversation\n- [GitHub Issues](https://github.com/mindfold-ai/Trellis/issues) — Report bugs \u0026 request features\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/mindfold-ai/Trellis/blob/main/LICENSE\"\u003eFSL License\u003c/a\u003e •\nMade with care by \u003ca href=\"https://github.com/mindfold-ai\"\u003eMindfold\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003csub\u003eFound Trellis useful? Please consider giving it a ⭐\u003c/sub\u003e\n\u003c/p\u003e\n","funding_links":[],"categories":["开发工具\u0026框架","Skills \u0026 Plugins","Python","Agent Infrastructure"],"sub_categories":["Multi-Agent Orchestration"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmindfold-ai%2FTrellis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmindfold-ai%2FTrellis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmindfold-ai%2FTrellis/lists"}