2.1.40 • Published 2d agoCLI

takomi

Licence

ISC

Version

2.1.40

Deps

Size

11.2 MB

Vulns

Weekly

Stars

Install scriptsThis package runs scripts during installation (preinstall/install/postinstall)

Summary Dependency Versions

Takomi

Stop Wrestling With AI. Start Building With Purpose.

The artisan's toolkit that transforms AI from chatbot to development partner

What Is Takomi?

AI shouldn't feel like a chatbot. It should feel like a teammate.

Takomi is a complete workflow system for collaborating with AI to build software. Think of yourself as the CEO, and your AI assistants as a specialized, high-performance development team — an Architect who plans, a Builder who implements, a Reviewer who catches mistakes, and an Orchestrator who coordinates them all.

This isn't prompt engineering. This is orchestrated development — a battle-tested collection of protocols, workflows, and skills that transform AI coding assistants into genuine project partners. It works across every major AI-powered IDE and even browser-based AI like ChatGPT and Claude.

Features

72+ Skills — Specialized capabilities from security audits to AI video generation, installed on demand
Universal IDE Sync — Install once, sync to Antigravity, Claude Code, Codex, Cursor, Kilo Code, Pi, and Windsurf
Full Project Lifecycle — From genesis (planning) through design, build, and finalize — with verification gates at every step
Specialized Agent Modes — Orchestrator, Architect, Coder, Debugger, Reviewer — each with purpose-built workflows
Codex-Native Skills — Use natural language (use takomi genesis) — no slash commands required
Pi Harness Integration — First-class Pi support with context management, model routing, and optional feature packs
Global Skills Router — One ~/.takomi/ store, synced to every IDE via symlinks or copy

Quick Start

npm install -g takomi
takomi setup

That's it. Takomi auto-detects your installed IDEs, creates your toolkit at ~/.takomi/, and syncs your selected skills everywhere.

# Day-to-day usage
takomi              # Launch in your current project
takomi status       # See what's connected
takomi refresh      # One-command update for everything
takomi doctor       # Run diagnostics

More install options (Pi, Codex, per-project, browser)

Pi Harness

takomi setup pi
cd my-project
takomi

Optional global skills and feature packs:

takomi setup skills        # Core Skills on first install, custom category browser on repeat
takomi setup pi-features   # Optional Pi packages (Interview, Todo, Browser QA, Doc Preview)

Codex Plugin Marketplace

Add the Takomi marketplace to Codex and browse plugins directly from the Codex UI:

Add the marketplace source — In Codex, go to Plugins → Add plugin marketplace and enter:

Field	Value
Source	`JStaRFilms/VibeCode-Protocol-Suite`
Git ref	`main`
Sparse paths	`.agents/plugins` `plugins`

Tip: For the full J StaR plugin catalog, use .agents/plugins and plugins as sparse paths instead.

Once added, search for "TakomiFlow" or "takomi-codex" inside the Codex plugin browser and install.

You can also use Takomi skills with natural language — no slash commands needed:

use takomi
use takomi genesis
continue build with takomi

See Takomi Codex Onboarding for activation, policy loading, roadbooks, and troubleshooting.

Per-Project Setup

Drop workflows into a single project without global install:

npx takomi init

Choose from .agent folder (Cursor, Windsurf, Gemini Code Assist), Agent YAMLs (Kilo Code), or legacy protocols (browser AI).

Global Install (Multi-IDE)

Install once. Use everywhere. Skills follow you across all detected AI harnesses:

npx takomi install

Browser-Based AI (ChatGPT, Claude.ai, Gemini)

Open a .md file from Legacy (Manual Method)/
Copy the entire prompt
Paste into your AI chat
Follow the conversation flow

#	Protocol	Purpose
1	Project Genesis Protocol	Start any new project
2	Ultimate Orchestration Prompt	One-shot prompt for quick scripts
3	Design System Genesis Protocol	Create visual design systems
5	Escalation & Handoff Protocol	When AI gets stuck
9	Reverse Genesis Protocol	Onboard AI to existing codebases

TakomiFlow (Google Flow Assets)

TakomiFlow packages Google Flow image/video generation as a Codex plugin with MCP tools plus a CLI fallback. It can generate Flow keyframes, short video shots, moodboards, collect downloaded assets, extract review frames, and record Flow project URLs.

.\scripts\install-takomi-flow.ps1 -InstallDependencies

See TakomiFlow Onboarding and TakomiFlow Public Distribution.

Skill Ecosystem

Think of skills as specialized team members you can summon on demand. Takomi ships 72+ skills organized by category.

Core Skills (Default Install)

takomi                 ai-sdk                 sync-docs
code-review            security-audit         optimize-agent-context
agent-recovery         avoid-feature-creep    git-commit-generation

Install More Skills

# Interactive browser — pick what you need
takomi setup skills

# Or via the external skills CLI
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite

Full skill categories

Developer / Frameworks — ai-sdk, nextjs-standards, context7, monorepo-management, upgrading-expo, github-ops, git-worktree, git-commit-generation, pr-comment-fix, jules, gemini, anti-gravity

Security / Review — security-audit, audit-website, code-review, jstar-reviewer, convex-security-audit, convex-security-check

Convex — convex, convex-agents, convex-best-practices, convex-component-authoring, convex-cron-jobs, convex-file-storage, convex-functions, convex-http-actions, convex-migrations, convex-realtime, convex-schema-validator, convex-security-audit, convex-security-check

Frontend / UI — frontend-design, web-design-guidelines, building-native-ui, ui-ux-pro-max, component-analysis, 21st-dev-components, stitch, webapp-testing

Docs / Office / Extraction — pdf, docx, pptx, xlsx, high-fidelity-extraction, crafting-effective-readmes, exam-creator-skill

Marketing / SEO / Copy — copywriting, marketing-ideas, pricing-strategy, programmatic-seo, seo-ready, social-content, twitter-automation, google-trends, domain-name-brainstormer, global-brand-namer, youtube-pipeline

AI Media / Content Creation — ai-avatar-video, ai-marketing-videos, ai-podcast-creation, ai-product-photography, ai-social-media-content, ai-voice-cloning, takomi-flow

Creative / Video / Art — algorithmic-art, blender-mcp-scene-director, takomi-flow, remotion, youtube-pipeline, ai-avatar-video, ai-marketing-videos, photo-book-builder

Skill Building / Prompting / Orchestration — skill-creator, prompt-engineering, subagent-driven-development, spawn-task

Workflows & Modes

Project Lifecycle

Command	What It Does
`/vibe-genesis`	Architect a new project — PRD, issues, guidelines
`/vibe-design`	Generate design system and page mockups
`/vibe-build`	Scaffold and build with verification gates
`/vibe-continueBuild`	Resume work in a new chat session
`/vibe-finalize`	Final verification and handoff report
`/reverse_genesis`	Onboard AI to an existing codebase

Specialized Modes

Command	Role	When to Use
`/mode-orchestrator`	Coordinator	Complex multi-agent projects
`/mode-architect`	Planner	System design before coding
`/mode-code`	Implementer	Day-to-day coding
`/mode-debug`	Diagnostician	Hard-to-find bugs
`/mode-ask`	Analyst	Explain without changing code
`/mode-review`	Reviewer	Pre-commit quality gates

Daily Commands

Command	What It Does
`/vibe-primeAgent`	Load project context at session start
`/vibe-spawnTask`	Break down complex features into tasks
`/vibe-syncDocs`	Update docs after code changes
`/escalate`	Generate escalation report when stuck
`/migrate`	Transfer context to a new session

Supported IDEs

Install once into ~/.takomi/ — Takomi syncs skills to each harness automatically.

Harness	Skills Path	Workflows Path
Antigravity	`~/.gemini/config/skills/`	`~/.gemini/config/global_workflows/`
Claude Code	`~/.claude/skills/`	—
Codex	`~/.codex/skills/`	—
Cursor	`~/.cursor/skills/`	—
Kilo Code	`~/.kilocode/skills/`	`~/.kilocode/workflows/`
Pi / Agent Skills	`~/.agents/skills/`	—
Windsurf	`~/.codeium/windsurf/skills/`	`~/.codeium/windsurf/global_workflows/`

CLI reference

Command	What It Does
`takomi`	Launch in the current project
`takomi setup`	Guided first-time setup
`takomi setup pi\|skills\|project\|all`	Targeted setup
`takomi refresh`	One-command update (CLI + Pi + skills)
`takomi refresh pi\|skills\|project\|all`	Targeted refresh
`takomi add <url>`	Pull skills from any GitHub repo
`takomi status`	See connections and toolkit status
`takomi doctor`	Run diagnostics

Legacy aliases: install → setup, sync/upgrade → refresh, init → setup project.

Context Manager (Pi)

Takomi ships a Pi-native takomi-context-manager extension that reduces prompt bloat with progressive context loading:

Skill names are always visible; descriptions and full SKILL.md files load only when needed
Tools: skill_manifest, skill_load, policy_manifest, policy_load, context_report
/takomi routing is the source of truth for model-routing policy
/context-report shows prompt compaction, loaded skills/policies, blocked actions, and diagnostics
Supports mode: "summary" | "verbose" | "problems"

Repository Structure

Folder	Purpose	Who It's For
`.agent/`	Workflows & Skills for agentic IDEs	Cursor, Windsurf, Gemini Code Assist
`Legacy (Manual Method)/`	Copy-paste prompts & protocols	Browser AI users
`Deep_Source_Prompts/`	Reference docs & source materials	Contributors, prompt engineers

Philosophy

Structured Collaboration — Clear roles for each AI agent, not free-form chatting
Documentation-Driven — Every project gets proper docs, issues, and roadmaps
Verification Gates — tsc --noEmit after every edit, 1:1 feature-to-issue mapping
Scalable — Works for tiny scripts or enterprise applications
Own Your Stack — No vendor lock-in, works across every major IDE

Contributing

This is a living system. If you discover improvements:

Test your changes with real projects
Add reference materials to Deep_Source_Prompts/ if needed
Create workflows in .agent/workflows/ for agentic IDEs
Update legacy prompts in Legacy (Manual Method)/ for browser users
Open a GitHub Issue with your proposed changes

Acknowledgements

Takomi-original skills, workflows, and runtime extensions — including 21st-dev-components — are authored and maintained by J StaR Films Studios.

Source	Skills / Packages
Pi by Mario Zechner / Earendil Works	MIT-licensed coding-agent runtime powering the Pi-native Takomi harness
Anthropic Skills	Office Suite (PDF/DOCX/PPTX/XLSX), Frontend Design, Webapp Testing, Algorithmic Art, Monorepo Management, Skill Creator
Inference.sh	Marketing Videos, Voice Cloning, Social Content, Twitter Automation, Product Photography, Prompt Engineering
Marketing Skills	Copywriting, Pricing Strategy, Social Strategy, Programmatic SEO, Marketing Ideas
Expo	Building Native UI, Upgrading Expo
Vercel AI SDK	AI SDK reference, Web Design Guidelines
UI/UX Pro Max	Premium design intelligence
Remotion	Programmatic video creation
Subagent Development	Advanced implementation planning
Context7	Library documentation fetcher
Audit Website	Professional website auditor
Convex Skills	Full Convex suite (Functions, Schema, Realtime, Agents, File Storage, Migrations, HTTP Actions, Cron, Components, Security)
Google Stitch	Design-to-code suite (design-md, enhance-prompt, stitch-loop, react-components, shadcn-ui)
Jules	Google Jules AI agent delegation
pi-subagents by Nico Bailon	Pi extension for delegated subagent runs
rpiv-ask-user-question by juicesharp	Structured user questions (optional Pi pack)
rpiv-todo by juicesharp	Live todo overlays (optional Pi pack)
pi-chrome by tianrendong	Browser automation (optional Pi pack)
pi-markdown-preview by omaclaren	Markdown/LaTeX previews (optional Pi pack)
context-mode by Mert Koseoğlu	External context-window project (not bundled)
kilocode by Kilo-Org	Git commit generation
pr-comment-fix	PR review comment automation

License

Takomi is licensed under the ISC License. Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.

Built with by artisans who code with the flow

Transform AI from a tool into a true development partner