Cline AutoPilot

One command. Production-ready rules for your Cline projects.

Cline is the open-source AI coding assistant that lives inside VS Code — it writes, refactors, and explains code in plain language. It turns a beginner into a confident developer, and gives a professional a force multiplier.

Cline AutoPilot removes the last manual step: it scans your project, detects the tech stack, and generates a complete, safe and documented set of rules (.clinerules) — in a single command. Cline then works predictably well from the very first keystroke.

Demo

Illustrative recording. CLI messages are currently localized in Russian; English localization is on the roadmap.

Features

• ⚡ One command — python _autopilot/start.py --auto does everything
• 🧠 Auto-detects your stack — language, framework, database, testing tools
• 📚 Generates .clinerules tailored to your project
• 🌍 Discovers best practices from GitHub (with a safety filter)
• 🛡️ Blocks dangerous patterns — eval, exec, rm -rf, DROP TABLE, os.system...
• ✅ Validates and auto-heals rules integrity
• 🗂️ Builds RULES_INDEX.md — every rule discoverable in seconds
• 📋 Writes NAPOMINALKA.md — a cheatsheet for working with the project
• 🔁 Reminds you to refresh rules every 5 days
• 🧩 Zero dependencies — pure Python standard library

How it works

flowchart LR
    A["1. Scan project<br/>(detect stack)"] --> B["2. Generate .clinerules"]
    B --> C["3. Discover best practices<br/>(GitHub)"]
    C --> D["4. Install safe rules"]
    D --> E["5. Build RULES_INDEX"]
    E --> F["6. Validate + auto-heal"]
    F --> G["7. Evaluate usage"]
    G --> H["8. Write NAPOMINALKA"]
    H --> I["Done — Cline follows the rules"]

Loading

Quick start

# 1. Copy the template into your project root
#    (or run the installer — see below)

# 2. Run AutoPilot
python _autopilot/start.py --auto

That's it. RULES_INDEX.md, NAPOMINALKA.md and a full .clinerules/ set are generated automatically.

Install

Windows — installer

install.bat

macOS / Linux — installer

./install.sh

Manual

# from your project root:
# Windows
xcopy /e /i template\* .
# macOS / Linux
cp -R template/. .

Requirements

• Python 3.10+
• Git

What you get

your-project/
├── .clinerules/              # rules for Cline
│   ├── base.md               # identity, bans, workflow
│   ├── meta.md               # self-check, reporting
│   ├── core/                 # autopilot, error-handling, logging
│   ├── modes/                # coding, design, doc, production, review
│   ├── workflows/            # git-commit, create-pr
│   └── templates/            # bug-fix, new-feature
├── _autopilot/               # the engine (start.py + core/)
├── tools/                    # index & validation utilities
├── RULES_INDEX.md            # every rule listed with a description
└── NAPOMINALKA.md            # "how to work with this project" cheatsheet

Customization

• Rules live in .clinerules/. Edit base.md for identity and bans, add your own rules under core/ or modes/.
• Index is auto-generated — never edit RULES_INDEX.md by hand:

  python _autopilot/start.py --skip-init --skip-discover --skip-evaluate

• Cheatsheet is regenerated on every full run.
• Reminder interval defaults to 5 days — set AUTOPILOT_CHECK_INTERVAL_DAYS in .env.

For Cline beginners

If you are new to Cline: install the Cline extension in VS Code, open your project, and start typing tasks in plain language — Cline writes the code. Cline AutoPilot makes sure Cline behaves consistently: safe commands, tested changes, documented work. Together they form a workflow that feels like having a senior engineer beside you.

Documentation

• GUIDE.md — full guide
• BEGINNER_GUIDE.md — for complete beginners
• CHANGELOG.md
• README.ru.md — Русская версия

Roadmap

• English CLI output
• Rules gallery / templates marketplace
• GitHub Actions for scheduled rule refresh

Contributing

Contributions are welcome! See CONTRIBUTING.md.

Security

Please report vulnerabilities responsibly — see SECURITY.md.

License

MIT