# humanlayer/12-factor-agents

What are the principles we can use to build LLM-powered software that is actually good enough to put in the hands of production customers?

26,911 stars · 2,017 forks · TypeScript

Topics: 12-factor, 12-factor-agents, agents, ai, context-window, framework, llms, memory

## Use it

### How to install 12-factor-agents in Claude Code

1. Clone & open

```bash
git clone https://github.com/humanlayer/12-factor-agents.git
cd 12-factor-agents
claude
```

2. Let Claude read it

   Ask “/init” to generate a CLAUDE.md, then have Claude explain, run, or extend the codebase. It reads files on demand.

### How to install 12-factor-agents in Claude Desktop

1. Clone the repository

```bash
git clone https://github.com/humanlayer/12-factor-agents.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

### How to install 12-factor-agents in Cursor

1. Clone & open in Cursor

```bash
git clone https://github.com/humanlayer/12-factor-agents.git
```

2. Index & chat

   Open the folder — Cursor indexes it automatically. Use @Codebase in chat to ask about it or scaffold from it.

### How to install 12-factor-agents in Codex CLI

1. Clone

```bash
git clone https://github.com/humanlayer/12-factor-agents.git
```

2. Point Codex at it

   Run codex in the repo root; add setup notes to AGENTS.md so the agent knows how to build & test.

### How to install 12-factor-agents in Windsurf

1. Clone & open

```bash
git clone https://github.com/humanlayer/12-factor-agents.git
```

2. Use Cascade

   Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.

### How to install 12-factor-agents in Cline

1. Clone the repository

```bash
git clone https://github.com/humanlayer/12-factor-agents.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

### How to install 12-factor-agents in VS Code

1. Clone the repository

```bash
git clone https://github.com/humanlayer/12-factor-agents.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

---

Source: https://mcp-skills-hub.vercel.app/repos/humanlayer-12-factor-agents · MCP Skills Hub · data as of 2026-10-28T12:31:05Z