How kaotypr/tembiter works
Tembiter is a setup CLI and a project-template convention: users initialize a project from a tagged template, connect an existing project, or install a packaged agent skill. The installed tembiter-sync skill supports a later, separate agent-led workflow for reviewing template changes in a worktree; the CLI itself does not perform updates. Source excerpts establish the CLI dispatch and core setup operations, while the later sync and optional PR behavior is documented in the README, so its internal implementation is not inferred here.
Main entry points: cli.ts CLI dispatcher · init.ts Initialize project · adopt.ts Adopt project · skill-install.ts Install skill
Components 19
CLI interaction
- CLI dispatcher
src/cli.ts - Setup picker
src/ui/picker.ts - Prompt interface
src/ui/prompt.ts - Init setup page
src/ui/init-setup.ts
Project setup
- Initialize project
src/commands/init.ts - Adopt project
src/commands/adopt.ts - Install skill
src/commands/skill-install.ts - Git runner
src/git.ts
Project format
- Sync ignore rule
src/format/gitignore.ts - Tembiter config
src/format/config.ts
Agent updates
- Skill catalog
src/skills/catalog.ts - Packaged skill
skills/tembiter-sync/SKILL.md - Sync worktree
- MR or PR
Other components
- User
- Template repository
- Project repository
- AI agent
- Git host
Connections 29
- User → CLI dispatcher: runs setup
- CLI dispatcher → Setup picker: offers commands
- CLI dispatcher → Prompt interface: prompts flags
- CLI dispatcher → Init setup page: collects init inputs
- CLI dispatcher → Initialize project: dispatches init
- CLI dispatcher → Adopt project: dispatches adopt
- CLI dispatcher → Install skill: dispatches install
- Initialize project → Git runner: runs git operations
- Initialize project → Template repository: archives tagged files
- Initialize project → Tembiter config: writes project config
- Initialize project → Sync ignore rule: adds sync ignore
- Initialize project → Project repository: creates and commits
- Adopt project → Git runner: checks and commits
- Adopt project → Template repository: reads tags and history
- Adopt project → Tembiter config: writes project config
- Adopt project → Sync ignore rule: adds sync ignore
- Adopt project → Project repository: updates setup files
- Git runner → Git host: invokes git
- Install skill → Skill catalog: resolves skill
- Install skill → Tembiter config: checks project kind
- Install skill → Packaged skill: copies packaged files
- Install skill → Project repository: writes skill and link
- AI agent → Packaged skill: follows installed skill
- AI agent → Template repository: compares template changes
- AI agent → Sync worktree: creates and reviews
- AI agent → Tembiter config: refreshes in worktree
- AI agent → Git host: creates worktree branch
- AI agent → MR or PR: may open
- MR or PR → Git host: submits branch