█████╗ ██╗   ██╗████████╗ ██████╗ ██████╗ ███████╗██╗   ██╗
  ██╔══██╗██║   ██║╚══██╔══╝██╔═══██╗██╔══██╗██╔════╝██║   ██║
  ███████║██║   ██║   ██║   ██║   ██║██║  ██║█████╗  ██║   ██║
  ██╔══██║██║   ██║   ██║   ██║   ██║██║  ██║██╔══╝  ╚██╗ ██╔╝
  ██║  ██║╚██████╔╝   ██║   ╚██████╔╝██████╔╝███████╗ ╚████╔╝
  ╚═╝  ╚═╝ ╚═════╝    ╚═╝    ╚══════╝ ╚═════╝ ╚══════╝  ╚═══╝

Set up any development environment in one command.

An open-source, cross-platform developer environment bootstrapper that automatically detects technologies, configures setups, installs missing runtimes, dependencies, SDKs, and dev tools.

---

Quick Start

# One-line install (Linux/macOS — adds to PATH automatically)
curl -fsSL https://raw.githubusercontent.com/HEETMEHTA18/autodev/main/scripts/install.sh | bash

# Windows (PowerShell — adds to user PATH automatically)
irm https://raw.githubusercontent.com/heetmehta18/autodev/main/scripts/install.ps1 | iex

# Or via NPX
npx autodev setup

# Or via PNPM
pnpm dlx autodev setup

# Or via Homebrew (macOS/Linux)
brew install HEETMEHTA18/tap/autodev

# Or via Scoop (Windows)
scoop install autodev

# Or via Docker
docker run --rm -v $(pwd):/workspace ghcr.io/heetmehta18/autodev setup

Upgrade the CLI anytime (works on Linux, macOS and Windows, no manual downloads):

autodev upgrade              # check + install the latest release
autodev upgrade --check-only # just check for a newer version
autodev upgrade --install-dir ~/.local/bin  # install to a specific folder

Then run in any repo to install its missing runtimes:

autodev setup

🚀 Bootstrap complete production-ready projects:

autodev create nextjs      # React, Standalone Docker, GitHub CI pipelines
autodev create ai-chatbot  # Express, React Vite UI, Gemini SDK integration
autodev create mern-stack  # MongoDB, Express, React, Node + docker-compose
autodev create flutter     # Dart mobile/web structure with web Nginx runner
autodev create react-ts    # Standard React, Vite builder, Tailwind styles

Tip

How it compares to npm create:

• npm create: Downloads a package and writes basic project skeleton files. The developer must manually run npm install before running the project.
• autodev create: Generates complete boilerplate files (folder structure, setups for Tailwind/PostCSS, multi-stage Dockerfiles, linter configs, CI/CD GitHub workflows) AND automatically executes dependency installations (pnpm/bun/yarn/npm install or flutter pub get) on the fly.

You are ready to build instantly! Simply run:

autodev create ai-chatbot my-agent-app
cd my-agent-app
pnpm dev  # or npm run dev

🛡️ Scan and configure missing requirements interactively:

autodev scan .

AutoDev will inspect your project, display missing configurations (like Tailwind CSS, Dockerfiles, ESLint rules, or GitHub Actions), and prompt to configure/install them for you on the fly!

---

🔍 What It Does

Command	Description
autodev scan	Scan current repo for languages, frameworks, package managers
autodev setup	Install all missing runtimes and dependencies
autodev audit	Audit repository dependencies for security vulnerabilities (OSV.dev)
autodev github <USER>	Scan all public repos of a GitHub user
autodev doctor	Check environment health
autodev report	Generate HTML/PDF/JSON environment report
autodev skills	Show personalized learning roadmap
autodev install <tool>	Install a specific runtime or tool
autodev opencode	Start a new OpenCode session with shared codebase knowledge
autodev agent <task>	Route a task to the best-fit AI agent
autodev upgrade	Upgrade the CLI to the latest release
autodev update	Update all managed runtimes
autodev clean	Remove cached downloads and temp files
autodev export	Export environment config as reproducible JSON

---

⚔️ Why AutoDev?

How does AutoDev compare to existing developer tools? Here is the matrix:

Feature	AutoDev ⚡	Dev Containers	Nix / Devenv	Homebrew / ASDF
Zero-Config Setup	Yes (Automatic)	No (Requires JSON/Docker)	No (Requires Nix expressions)	No (Manual installs)
Monorepo Polyglot Scan	Yes	No	No	No
Git-History Skill Intelligence	Yes	No	No	No
Interactive Terminal TUI	Yes	No	No	No
Lightweight (No VM/Docker needed)	Yes	No (Requires Docker)	Yes	Yes

---

🤖 Integrations & AI Agent Adoption

AutoDev serves as the local environment automation and telemetry layer for developers and modern AI agents / Coding Assistants (like Cursor, Claude Desktop, Windsurf, Cline, and Copilot).

⚡ Automatic AI Rule Files & 99.8% Context Saving

Whenever any AutoDev command is run in a project workspace, AutoDev automatically creates/updates standard AI rules files:

• .autodev-skills.md (Unified skills matrix, CLI cheatsheet, and environment telemetry)
• .cursorrules (Cursor AI agent rules)
• .clinerules (Cline/Roo-Cline rules)
• .github/copilot-instructions.md (GitHub Copilot instructions)

These rules instruct AI Agents to use AutoDev's telemetry instead of parsing directory structures or lockfiles recursively. This reduces context payloads from 200,000+ tokens to ~350 tokens (a 99.8% token context saving) per roundtrip.

🧠 Shared-Knowledge OpenCode Sessions

autodev opencode launches a new OpenCode session that is aware of the whole project. Before launching, AutoDev writes a shared knowledge file (.autodevs/context/opencode-knowledge.md) that captures:

• Repository state — branch, HEAD, working-tree changes, and the uncommitted diff
• Detected stack — languages, frameworks, package managers, databases
• AutoDev memory — successes, patterns, and mistakes from past loops
• Session outcomes — a running log of what previous sessions did

Each session reads that file for grounding, and AutoDev appends the outcome when the session finishes — so every new session knows what changed, what is in use, and what to do next.

autodev opencode "fix the auth bug"   # one-off task
autodev opencode                       # interactive session

👱‍♂️ Ponytail "Lazy Senior Dev" Mode (NEW)

AutoDev now integrates Ponytail principles natively across all AI Agent rule files (.cursorrules, .clinerules, etc.). When you run autodev ponytail, AutoDev injects an overpowering prompt prioritizing YAGNI (You Aren't Gonna Need It), standard libraries, and extreme minimalism.

Third-Party Benchmarks (promptfoo via Claude 3.5 Haiku)
Compared to a standard coding assistant without AutoDev + Ponytail:

• Lines of Code (LOC): -54%
• Tokens Used: -22%
• Time Taken: -27%
• Cost: -20%

Credit to the original Ponytail Project by DietrichGebert for pioneering the Lazy Senior Dev agent methodology.

Programmatic Usage

AI agents can invoke autodev or call its MCP tools to discover, verify, or install dependencies:

• Environment Discovery: Run autodev scan or call the autodev_scan tool to detect languages, frameworks, package managers, and databases.
• Environment Bootstrapping: Run autodev setup --yes or call the autodev_install tool to automatically and hermetically install missing tools.
• Diagnostics Check: Run autodev doctor or call the autodev_doctor tool to verify compiler path health, gitignore setups, and local configurations.
• Auto-Fixes: Run autodev doctor --fix (or autodev_doctor tool with {"fix": true}) to automatically repair misconfigured developer toolchains.

---

🗺️ Product Roadmap

AutoDev is actively developed with a clear vision to become the ultimate intelligence and automation layer for developer environments.

graph TD
    A[v0.1.0 Foundation] --> B[v0.2.0 Ecosystem]
    B --> C[v0.3.0 Intelligence]
    C --> D[v1.0.0 Production]

    subgraph v0_2_0 ["v0.2.0 Ecosystem (Current)"]
    B1[Docker & K8s Detection]
    B2[20+ Language Runtimes]
    B3[Visual Roadmap Viewer TUI]
    end

    subgraph v0_3_0 ["v0.3.0 Intelligence (Next)"]
    C1[Local AI Assistant]
    C2[DevContainer Config Gen]
    C3[Nix Flake Integration]
    C4[Doctor Auto-Remediation]
    end

Loading

Future Milestones Summary:

• ✅ v0.1.0 — Foundation: Core Go scanner engine, scan diagnostics reports, and basic catalog installer.
• ✅ v0.2.0 — Ecosystem Expansion (Current): Expanded support for 20+ runtimes (Composer, Bundler, Maven, Android SDK, Helm), visual BubbleTea roadmap TUI, native Claude/Cursor MCP server auto-setup, and reproducible lockfile generation (autodev.lock.json).
• 🚧 v0.3.0 — Intelligence Layer (Next):
  • Local AI Assistant: local LLM chatbot support (via Ollama/llama.cpp) for answering dependency/setup queries inside the CLI.
  • DevContainer / Cloud IDE Gen: Auto-generating .devcontainer.json or Codespaces configuration templates directly from project scanner telemetry.
  • Doctor Auto-Remediation: Adding --fix flag to autodev doctor to resolve and install missing runtimes automatically.
  • Team Sync & Locking: Locking team development environments with shared config unlocks.
• 🌐 v1.0.0 — Production Release: Finalizing SemVer stable API specifications, hosted SaaS team dashboard, SSO integration, and SOC2 compliance.

👉 For the complete feature-by-feature breakdown, checklist, and experimental ideas, see our detailed ROADMAP.md.

---

🏗️ Project Structure

autodev/
├── apps/
│   └── website/          # Next.js 15 marketing site + docs
├── packages/
│   ├── cli/              # Go CLI (cobra + bubbletea)
│   ├── core/             # OS/arch detection, config
│   ├── scanner/          # Repo + GitHub scanner
│   ├── installer/        # Runtime installer
│   ├── skills/           # skills.sh integration
│   └── github/           # GitHub API client
├── scripts/
│   ├── install.sh        # Curl installer
│   └── build.sh          # Build script
├── .github/
│   └── workflows/        # CI/CD pipelines
├── go.work               # Go workspace
├── pnpm-workspace.yaml   # PNPM workspaces
└── turbo.json            # Turborepo config

---

🤝 Contributing

We welcome contributions of all kinds! Please read CONTRIBUTING.md to get started. To understand the whole project delete the project_context.md from the root so that any of you can understand and context of the project or the real motive of this project.

• 🐛 Report a Bug
• 💡 Request a Feature
• 📖 Improve Docs

---

📜 License

MIT © AutoDev Contributors