$git clone https://github.com/sbhooley/ainativelang> AI-led co-development project, human-initiated by Steven Hooley (x.com/sbhooley, stevenhooley.com, linkedin.com/in/sbhooley). Attribution details: docs/PROJECT_ORIGIN_AND_ATTRIBUTION.md and tooling/project_provenance.json. -- This project was named by AI :)
| 1 | # AI Native Lang (AINL) |
| 2 | |
| 3 | <p align="center"> |
| 4 | <img src="docs/assets/ainl_logo.png" alt="AINL logo" width="220" /> |
| 5 | </p> |
| 6 | |
| 7 | <p align="center"> |
| 8 | Find Us on X: <a href="https://x.com/ainativelang">@ainativelang</a> |
| 9 | </p> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+" /> |
| 13 | <a href="https://github.com/sbhooley/ainativelang/tags"> |
| 14 | <img src="https://img.shields.io/github/v/tag/sbhooley/ainativelang?label=release" alt="Latest tag" /> |
| 15 | </a> |
| 16 | <a href="tests/snapshots/conformance/summary.md"> |
| 17 | <img src="tests/snapshots/conformance/conformance_badge.svg" alt="Conformance status" /> |
| 18 | </a> |
| 19 | <a href="https://github.com/sbhooley/ainativelang/actions/workflows/sync-ecosystem.yml"> |
| 20 | <img src="https://github.com/sbhooley/ainativelang/actions/workflows/sync-ecosystem.yml/badge.svg" alt="Auto-sync OpenClaw/NemoClaw/Clawflows/Agency-Agents" /> |
| 21 | </a> |
| 22 | <a href="LICENSE"> |
| 23 | <img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License: Apache-2.0" /> |
| 24 | </a> |
| 25 | <img src="https://img.shields.io/badge/MCP-v1%20server-blueviolet" alt="MCP v1" /> |
| 26 | <a href="https://github.com/sbhooley/ainativelang/tree/main/skills/ainl"> |
| 27 | <img src="https://img.shields.io/badge/ZeroClaw%20Skill-AINL-blue" alt="ZeroClaw Skill: AINL" /> |
| 28 | </a> |
| 29 | <a href="https://github.com/sbhooley/ainativelang/tree/main/skills/openclaw"> |
| 30 | <img src="https://img.shields.io/badge/OpenClaw%20Skill-AINL-blue" alt="OpenClaw Skill: AINL" /> |
| 31 | </a> |
| 32 | <a href="https://github.com/NousResearch/hermes-agent"> |
| 33 | <img src="https://img.shields.io/badge/Hermes%20Agent-AINL-blue" alt="Hermes Agent: AINL" /> |
| 34 | </a> |
| 35 | <img src="https://img.shields.io/badge/graph--first-deterministic%20IR-orange" alt="Graph-first deterministic IR" /> |
| 36 | <img src="https://img.shields.io/badge/AI%20workflow-language-brightgreen" alt="AI workflow language" /> |
| 37 | </p> |
| 38 | |
| 39 | > AI-led co-development project, human-initiated by Steven Hooley (`x.com/sbhooley`, `stevenhooley.com`, `linkedin.com/in/sbhooley`). Attribution details: `docs/PROJECT_ORIGIN_AND_ATTRIBUTION.md` and `tooling/project_provenance.json`. -- This project was named by AI :) |
| 40 | |
| 41 | --- |
| 42 | |
| 43 | ## For agents — install AINL (one step) |
| 44 | |
| 45 | If you are an AI coding agent (Claude Code, Cursor, Cline, Codex, Aider, …) |
| 46 | or any MCP-capable runtime and the user wants AINL added to their stack, |
| 47 | run **one command**: |
| 48 | |
| 49 | ```bash |
| 50 | pipx install 'ainativelang[mcp]' && ainl setup --auto |
| 51 | ``` |
| 52 | |
| 53 | Fallback if `pipx` is unavailable: |
| 54 | |
| 55 | ```bash |
| 56 | python3 -m pip install --user 'ainativelang[mcp]' && ainl setup --auto |
| 57 | ``` |
| 58 | |
| 59 | That is the entire install. The `setup` command auto-detects every host |
| 60 | present (Claude Code project + user, Cursor, Cline, Codex CLI/Desktop, |
| 61 | Claude Desktop, OpenClaw, Hermes, ArmaraOS, or any generic MCP host), |
| 62 | merges the right MCP server entry into each config file (atomic write, |
| 63 | timestamped backup), and verifies with `ainl doctor`. Idempotent — safe |
| 64 | to re-run. |
| 65 | |
| 66 | If a host is not auto-detected, run `ainl setup --print-config` for a |
| 67 | paste-ready stdio MCP server block. |
| 68 | |
| 69 | Machine-readable spec: [`.agent-install.json`](./.agent-install.json) · |
| 70 | Design: [`docs/architecture/2026-05-05-agent-install-simplification.md`](docs/architecture/2026-05-05-agent-install-simplification.md). |
| 71 | |
| 72 | --- |
| 73 | |
| 74 | ## Is AINL for you? (60-second filter) |
| 75 | |
| 76 | Before the install commands, here is who AINL is and is not for. We would rather you self-select out in 60 seconds than spend a week on a tool that does not fit. |
| 77 | |
| 78 | | ✅ AINL is for you if… | ❌ AINL is *not* for you if… | |
| 79 | |:----------------------|:----------------------------| |
| 80 | | Your agents (Cursor, Claude Code, autonomous loops) **author runner / orchestration code** and have shipped broken Python more than once | You write all your runners by hand and your CI test suite catches the bugs | |
| 81 | | You run **20+ recurring monitor / digest / scheduled jobs** that currently **re-prompt an LLM on every run** to decide routing | You already have deterministic runners with the LLM only at judgment gates — congrat |