protoagent/README.md

Interactive AI coding agent CLI with file system capabilities and shell command execution

# ProtoAgent

🤖 **Interactive AI coding agent that can read, write, and execute files in your terminal.**

## Get Started

```bash
npm install -g protoagent
protoagent
```

That's it! ProtoAgent will guide you through setup and start helping with your coding tasks.

## What it does

- **File Operations** - Read, write, edit, and search files
- **Shell Commands** - Execute terminal commands safely
- **Code Analysis** - Understand and analyze your codebase
- **Project Generation** - Create files, folders, and entire project structures
- **Interactive Chat** - Natural language interface for all coding tasks

## Example Usage

```
protoagent> Create a React component called Button.tsx
protoagent> Find all TODO comments in my project
protoagent> Set up a Node.js Express server with TypeScript
protoagent> Debug this error in my package.json
protoagent> Show me the structure of my src folder
```

## Requirements

- Node.js 16+
- OpenAI API key (you'll be prompted to set this up on first run)

## License

MIT