A team starts
with a file.

Clone your factory.

git clone https://github.com/bgoleno/fabrikito.git
cd fabrikito
cp teams/example.yaml teams/team.yaml

Fabrikito runs from its checkout. No orchestration server or Ruby gems required.

Configure the team.

Edit teams/team.yaml: set repo.path, repo.github, your storage volume, project board, and roles. The main checkout’s origin must match the GitHub repository you name.

Start with a small roster. You can choose each role’s model, effort, prompts, and permission rules.

Open for work.

./fabrikito check
./fabrikito up
./fabrikito say em "What is the plan for today?"

Read the validation output before starting. Answer any trust or permission dialogs in the seats. Without iTerm, use ./fabrikito up --no-view.

Come and go.

./fabrikito status
./fabrikito view
./fabrikito down --yes

Closing the iTerm tab detaches. down stops the seats and keeps their worktrees. The owner can delegate merging to the EM with an explicit or standing instruction in its pane.