AI-powered terminal that speaks human
A revolutionary terminal experience where you can type commands OR ask in natural language. Berto is your AI assistant that understands both traditional shell commands and conversational requests.
- 🧠 AI-Powered: Ask naturally - "show me files", "create a folder", "help me find something"
- ⚡ Real Commands: Execute actual shell commands on your machine (local) or simulated environment (remote)
- 🌐 Hybrid Mode: Works seamlessly both locally and on remote deployments (Vercel)
- 🎨 Beautiful UI: Modern, responsive terminal interface with proper theming
- 📱 Mobile Friendly: Optimized touch experience for mobile devices
- 🔍 Smart Context: AI understands your current directory and available files
- 🎯 Inline Input: Clean, authentic terminal feel with proper prompt alignment
- Node.js 18+
- pnpm (recommended) or npm
- OpenAI API key
# Clone the repository
git clone https://github.com/kemenystudio/berto.git
cd berto
# Install dependencies (use pnpm for best results)
pnpm install
# Set up environment variables
cp .env.example .env.local
# Add your OPENAI_API_KEY to .env.local
# Start development server
pnpm devCreate a .env.local file with:
OPENAI_API_KEY=your-openai-api-key-hereAsk Berto anything in plain English:
- "show me the files in this folder" → runs
ls - "create a project folder and call it 'bananas'" → runs
mkdir bananas - "help me find all text files" → runs
find . -name "*.txt" - "what's in my home directory?" → runs
ls ~
All standard shell commands work perfectly:
ls -la # List files with details
cat filename.txt # Read file contents
mkdir new-folder # Create directory
cd Documents # Change directory
pwd # Show current directory
grep "text" *.txt # Search in filesTry these built-in commands:
help- See all available commands and tipshack- Start an immersive AI-powered cyber hacker challengeclear- Clear the terminal screen
Experience Berto's interactive cyber security challenge:
hack # Start the challenge
cd intel # Navigate to intel directory
cat CODE_1.dat # Find your first access code
cat ../matrix.dat # Decode the matrix for CODE_2
cd ../vault # Enter the final vault challengeFeatures:
- 🕵️ Immersive Story: Realistic hacker scenario with classified files
- 🔐 Progressive Puzzles: Find 3 access codes through different challenges
- 🧭 Full Navigation: Complete
cdsupport for directory exploration - 🤖 AI-Generated Content: Dynamic hints and responses
- 🎯 Educational: Learn real terminal commands while playing
- 🖥️ Native Performance: Direct access to your local filesystem
- ⚡ Real Commands: Execute actual shell commands on your machine
- 🔄 Instant Feedback: No network delays, immediate responses
- 🌐 Simulated Environment: Virtual filesystem for safe command execution
- 🤖 AI-Enhanced: Intelligent command interpretation and responses
- 🛡️ Secure: Sandboxed environment prevents system access
- GPT-4 Powered: Natural language understanding and command generation
- Context Aware: Understands your current directory and available files
- Smart Suggestions: Provides helpful tips and alternative commands
- Connect your repository to Vercel
- Set environment variables in Vercel dashboard:
OPENAI_API_KEY: Your OpenAI API key
- Deploy - Vercel will automatically build and deploy
The project is configured with:
- ✅
vercel.jsonwith proper pnpm configuration - ✅ Optimized build settings
- ✅ API routes with appropriate timeouts
- ✅ Edge runtime compatibility
For other deployment platforms, ensure:
- Node.js 18+ runtime
- Environment variables are set
- Build command:
pnpm build - Start command:
pnpm start
berto/
├── app/ # Next.js app router
│ ├── api/ # API routes
│ │ ├── ai/ # AI command processing
│ │ └── execute/ # Command execution
│ ├── layout.tsx # Root layout
│ └── page.tsx # Main page
├── src/ # Source code
│ ├── components/ # React components
│ │ ├── ui/ # Shadcn/ui components
│ │ └── terminal.tsx # Main terminal component
│ ├── services/ # Core services
│ │ ├── ai-interpreter.ts
│ │ ├── shell-executor.ts
│ │ ├── hybrid-filesystem.ts
│ │ └── environment-detector.ts
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utilities
│ ├── types/ # TypeScript definitions
│ ├── commands/ # Command definitions
│ └── styles/ # CSS styles
├── config/ # Configuration files
├── public/ # Static assets
└── [config files] # Next.js, TypeScript, etc.
- AI Interpreter: Processes natural language and converts to commands
- Shell Executor: Executes commands safely in both environments
- Hybrid Filesystem: Manages files in local/remote contexts
- Environment Detector: Determines runtime environment
- Frontend: Next.js 15, React 19, TypeScript
- Styling: Tailwind CSS, Shadcn/ui components
- AI: OpenAI GPT-4, Vercel AI SDK
- Icons: Lucide React
- Package Manager: pnpm (recommended)
- File Operations: Enhanced file manipulation commands
- Git Integration: Direct git command support
- Theme Customization: Multiple terminal themes
- Command History: Persistent command history
- Tab Completion: Smart command completion
- Session Management: Multiple terminal sessions
- ✅ Full Directory Navigation: Fixed
cdcommand support in remote/simulated environments - 🕵️ Intel Directory: Added interactive intel files with mission briefings and classified documents
- 🔐 Progressive Puzzle System: Complete 3-stage access code discovery
- 🎯 Improved UX: Better error handling and helpful guidance for players
- 🤖 AI Integration: Dynamic content generation for hints and responses
- v1.1.0: Added natural language processing and AI command interpretation
- v1.0.0: Initial release with basic terminal functionality
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
MIT License - see LICENSE file for details.
- Built with Next.js, React, and OpenAI
- UI components powered by Radix UI and Tailwind CSS
- Terminal experience inspired by modern CLI tools