Team1 Factory — AI skill for Claude Code

Team1 Software Factory

**Turn GitHub issues into shipped software.**

Visit [tryteam1.com](https://tryteam1.com) for the latest updates.

Team1 is a local-first, agentic software factory for GitHub. Point it at your repositories and it runs:

**triage → plan → implement → test → review → pull request → merge**

Claude Code agents do the engineering work while Team1 manages branches, worktrees, gates, reviews, and pull requests. You can stay in the loop for decisions or enable auto-merge.

Team1 runs as a single process on infrastructure you control, using your Claude Code login and GitHub account.

See it work

[Team1-demo](https://github.com/Team1-dev/Team1-demo) is a demo app repository that Team1-Factory is building one issue at a time. Every [issue](https://github.com/Team1-dev/Team1-demo/issues?q=is%3Aissue) shows the stages as comments, from triage to merge with the total cost of each. Every [pull request](https://github.com/Team1-dev/Team1-demo/pulls?q=is%3Apr) was opened, reviewed and merged by Team1-Factory.

---

[!CAUTION]

⚠️ WARNING — run Team1 on an isolated machine

**Do not run Team1 on your personal computer.** Use a disposable VPS, VM, container, or other isolated environment.

Team1 runs Claude Code with permission checks disabled and executes commands from managed repositories. It also has access to GitHub and Claude Code credentials.

• Use a dedicated VPS, VM, or container.
• Use a dedicated GitHub account with access only to required repositories.
• Do not store personal credentials, SSH keys, cloud credentials, or other secrets on the host.
• Assume code in a managed repository can execute with Team1's permissions.
• Prefer testing with a private repository; public repositories are not tested.

Requirements

• A fresh Linux VPS. The steps below are for Ubuntu or Debian.
• Node.js 22.18+
• git, jq, npm
• pnpm if required by a repository
• Claude Code, installed and logged in
• Dedicated GitHub acc