AI-powered development assistant that executes commands and builds projects
npm install sapper-iqš AI-powered development assistant that executes commands and builds projects
Sapper is a command-line interface that connects to Ollama models to help you build, manage, and execute development tasks through natural language conversations.
- š¤ AI-powered assistance - Chat with local Ollama models
- š ļø Multi-tool execution - File operations, shell commands, directory management
- š¬ Conversational interface - Natural language project management
- š Session persistence - Resume previous conversations
- šÆ Context-aware - Automatically detects directory contents
- ā” Live streaming - See AI responses in real-time
- š Security prompts - Review commands before execution
``bash`
npm install -g sapper
- Node.js 16+
- Ollama installed and running
- At least one Ollama model downloaded
`bash`
sapper
- /reset or /clear-session - Start a new session/session-info
- - Show current session details /step
- - Toggle step-by-step mode/help
- - Show command helpexit
- - Exit Sapper
`
> set up a React project in ./my-app
> run the development server
> create a login component with TypeScript
> add Tailwind CSS styling
1. Connect to Ollama - Choose from your available local models
2. Natural conversation - Describe what you want to build or do
3. AI executes tools - Creates files, runs commands, manages projects
4. Review & approve - Security prompts for shell commands
5. Context awareness - Sapper understands your project structure
- SHELL - Execute terminal commandsREAD
- - Read file contentsWRITE
- - Create/edit filesMKDIR
- - Create directoriesLIST
- - List directory contentsSEARCH
- - Search for text in files
Create a Next.js project:
`
> create a Next.js app with TypeScript and Tailwind in ./my-nextjs-app
Add features to existing project:
`
> analyze the codebase in ./my-project
> add a user authentication system
> create API endpoints for user management
`bash``
git clone https://github.com/yourusername/sapper
cd sapper
npm install
chmod +x sapper.mjs
./sapper.mjs
MIT
Ibrahim Ihsan