🛠️ buildme

AI-powered CLI assistant for developers.
Undo commands. Scaffold projects. Record terminal workflows. All from your terminal.

⚡️ Features

• 🔁 buildme undo — Revert recent terminal or buildme commands
• 🚀 buildme starter — Initialize projects from folders or GitHub repos
• ✨ buildme generate — Natural-language shell command generation
• 📼 buildme record — Record and replay your terminal workflows
• 💾 buildme snapshot/restore — Save and restore directory states
• 📤 buildme share — Convert terminal sessions into shareable markdown docs
• 🧠 Smart model switching (gpt-4o-mini, DeepSeek, local models)
• ✅ Built for speed, safety, and zero-bloat workflows

🛠️ buildme vs. Popular AI CLI Tools

Feature	buildme	shell-gpt	GitHub Copilot CLI	aider	AI-Shell
🤖 Natural Language Commands	✅	✅	✅	✅	✅
🔁 AI-Powered Undo	✅	❌	❌	❌	❌
📼 Record Terminal Workflows	✅	❌	❌	❌	❌
🔄 Replay Recorded Sessions	✅	❌	❌	❌	❌
📤 Share as Markdown Docs	✅	❌	❌	❌	❌
🌍 OS Command Conversion	✅	❌	❌	❌	❌
🚀 Project Scaffolding	✅	❌	❌	❌	❌
💾 Directory Snapshots	✅	❌	❌	❌	❌
⚡ Step-by-Step Execution	✅	✅	❌	❌	❌
📋 Auto Copy to Clipboard	✅	❌	❌	❌	❌
🔧 Code Editing / Diffing	❌	❌	✅	✅	❌
📚 Git Integration	❌	❌	✅	✅	❌
💬 Interactive Chat Mode	❌	✅	✅	✅	✅
🏢 Share Workflows with Teams	✅	❌	❌	❌	❌
🎯 Primary Use Case	Workflow Automation & Safety	Command Gen	GitHub Copilot	Inline Code Editing	Terminal Chat

---

🔧 Installation

git clone https://github.com/yourusername/buildme.git
cd buildme

# Zsh setup (supports .zsh)
echo "source $PWD/buildme.plugin.zsh" >> ~/.zshrc
source ~/.zshrc

🚀 Usage

✨ Generate shell code with AI

buildme "create a python venv and install requests"

Run immediately or step-by-step:

buildme --run "install packages and write requirements.txt"
buildme --step "set up project directory and init Git"

🔁 Undo terminal actions

buildme undo

Optionally describe what to undo:

buildme undo "remove venv folder"

🚀 Project Starters

Create a new project from a template:

buildme starter new fastapi my-api

Scaffold from a GitHub repo or folder:

buildme starter init my-app https://github.com/user/repo
buildme starter init cli-tool /Users/dev/templates/cli

List or delete:

buildme starter list
buildme starter delete old-template

📼 Record & Replay Terminal Workflows

Record a session:

buildme record start setup-node
# do stuff in terminal...
buildme record stop

Replay it:

buildme record replay setup-node
buildme record replay path/to/file.sh

Rename or list:

buildme record rename setup-node node-env
buildme record list

💾 Snapshots & Restore

Save a full project snapshot:

buildme snapshot pre-refactor

List or delete:

buildme snapshot list
buildme snapshot delete pre-refactor

Restore snapshot:

buildme restore pre-refactor
buildme restore pre-refactor --to ./backup
buildme restore pre-refactor --overwrite
buildme restore pre-refactor --dry-run

📤 Share Workflows

Convert any session, record, or history into a Markdown doc:

# Share a recorded terminal session
buildme share my-workflow

# Share the last buildme session
buildme share --session

# Share recent commands from terminal history
buildme share --history 15

Optional flags:

--convert macos         # Convert commands for macOS, Linux, etc.
--include-env           # Include OS, shell, and version details
--no-ai-summary         # Skip the AI-generated summary

--dry-run               # Preview without saving
--filter-meaningful     # Filter out commands like `ls`, `cd`, `pwd`
--no-filter             # Include all commands (no filtering)

Manage shared files:

buildme share list
buildme share delete my-workflow-2025-05-29
buildme share clean

🧠 AI Model Management

buildme model list           # Show available models
buildme model set gpt-4o     # Set your preferred model
buildme model clear          # Clear all stored API keys
buildme init                 # Interactive key setup (OpenAI, DeepSeek)

🔍 Examples

# Reverse a bad install
buildme undo

# Generate a zip-cleanup script
buildme "bash script to zip all logs older than 7 days"

Scaffold a FastAPI project

buildme starter new fastapi my-api

Record a React setup session

buildme record start react-setup
npm create vite@latest
npm install
buildme record stop
buildme record replay react-setup

Save project before trying new changes

buildme snapshot pre-experiment

🧩 Project Structure

buildme.plugin.zsh         # Main CLI entrypoint
core/                      # Internal logic (generate, run, undo, etc.)
commands/                  # Features like snapshot, record, starter
lib/                       # Helpers and utilities

🔮 Coming Soon

• 🧠 buildme explain — Understand any terminal command or file

🤝 Contributing

Pull requests welcome!

git clone https://github.com/yourusername/buildme.git
cd buildme

👤 Author

Dev Paragiri Website • Twitter/X

⚡ If you use buildme, tweet me your workflows — I love seeing what devs are cooking.