agentic-code

# Agentic Code — AGENTS.md Workflow Framework for AI Coding Agents

Agentic coding workflows for Cursor, Codex, Cursor CLI, and any
AGENTS.md-compatible tool. Zero config, test-first, language-agnostic.

[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![AGENTS.md](https://img.shields.io/badge/AGENTS.md-compliant-blue.svg)](https://agents.md)
[![Version](https://img.shields.io/badge/version-0.6.7-blue.svg)](package.json)

![Demo: Building a Slack bot with Agentic Code](.github/assets/demo.gif)

*AI builds a Slack bot with tests & docs — in 30s*

## How Agentic Code Works

```
You: "Build a Slack bot with Cursor API"
AI:  ✓ Reads AGENTS.md
     ✓ Analyzes requirements
     ✓ Plans architecture
     ✓ Writes tests first
     ✓ Implements with best practices
     ✓ Verifies everything works
```

**Works out of the box — no configuration required.**

## Quick Start (30 seconds)

```bash
npx agentic-code my-project && cd my-project
# Ready to go
```

That's it. Works with **Cursor, Codex, Cursor CLI**, and [many AGENTS.md-compatible tools](https://agents.md).

## Compatible Tools

| Tool | Support | Notes |
|------|---------|-------|
| [Cursor](https://cursor.com) | Primary | Skills installation via `npx agentic-code skills --cursor` |
| [Codex](https://github.com/openai/codex) | Primary | Skills installation via `npx agentic-code skills --codex` |
| [Cursor CLI](https://github.com/google-cursor/cursor-cli) | Primary | Reads AGENTS.md automatically |
| Any AGENTS.md tool | Compatible | [See full list at agents.md](https://agents.md) |

## Using Codex?

If you mainly use Codex, see [codex-workflows](https://github.com/shinpr/codex-workflows) for a more Codex-specific setup.

It includes subagents-based isolation for review and verification tasks, improving reliability by separating context inside the same working session.

## Problems with AI Coding Agents

Every AI coding tool has the same problems:
- Forgets your project structure after 10