✨ Glimx - AI-Powered Terminal Coding Agent

The modern AI coding assistant that lives in your terminal

🌐 Website • 🚀 Quick Start • 📖 Documentation • 🆓 Free Models • 💬 Community

🎯 What is Glimx?

Glimx is a powerful AI-powered coding agent designed for developers who love the terminal. Built on OpenCode's proven architecture with enhanced features, Glimx brings AI assistance directly to your command line without expensive API costs.

✨ Key Features

• 🆓 Free AI Models - Works with Qwen, DeepSeek, Mistral via OpenRouter, Groq, and Cerebras
• 🔌 5 Built-in MCP Servers - Filesystem, Git, Sequential Thinking, Fetch, Memory
• 🧠 Sequential Thinking - AI breaks down complex problems step-by-step
• 🔒 Smart Permissions - Granular control over dangerous operations
• 💾 Memory System - Persistent knowledge graph across sessions
• 🎨 Beautiful UI - Modern terminal aesthetics with 20+ themes and animated elements
• ⚡ Lightning Fast - Powered by Bun runtime
• 🔧 Developer Tools - LSP support, templates, watch mode, and more

📸 Screenshots

Interactive Chat Session

🚀 Quick Start

Installation

npm install -g glimx

Get Free API Keys

Choose one (or more) free providers:

• Groq (Recommended): https://console.groq.com/keys - 1,000 req/day, ultra-fast
• OpenRouter: https://openrouter.ai/keys - 20 req/min, multiple models
• Cerebras: https://cloud.cerebras.ai/console - Free tier available

Configure

# Set your API key
export GROQ_API_KEY="your-groq-key-here"

# Add to shell profile for persistence
echo 'export GROQ_API_KEY="your-key"' >> ~/.zshrc

Run

# Start with free model
glimx --model groq/qwen-32b

# Or just run interactive mode
glimx

# Run with a message
glimx run "explain this code"

# Pipe input
git diff | glimx run "explain changes" -

💡 Usage Examples

Basic Commands

# Interactive chat
glimx run "create a REST API with Express"

# Pipe from other commands
ps aux | grep node | glimx run "which process uses most memory?" -
cat error.log | glimx run "find the root cause" -

# File operations
glimx diff old.js new.js -m "explain changes"
glimx goto src/index.ts:42 -m "explain this function"

# Project scaffolding
glimx init react-vite my-app
glimx init python-fastapi my-api

# Watch mode
glimx watch src/ --test

Inside Glimx Session

/chat        # Start new chat
/sessions    # Browse history
/models      # Switch AI model
/commands    # Show all commands
/compact     # Summarize session to save tokens
/undo        # Undo last message
/help        # Show help

🆓 Free AI Models

Glimx supports multiple free AI models:

| Model | Provider | Best For | Speed | Context | |-------|----------|----------|-------|---------| | Qwen 3 32B | Groq | Coding | ⚡⚡⚡ | 32K | | DeepSeek V3.1 | OpenRouter | Reasoning | ⚡⚡ | 64K | | Llama 3.3 70B | Groq/Cerebras | General | ⚡⚡⚡ | 128K | | Qwen 3 235B | Cerebras | Complex Tasks | ⚡⚡ | 128K | | Mistral Small | OpenRouter | Balanced | ⚡⚡ | 32K |

Configure in ~/.opencode/config.json:

{
  "model": "groq/qwen-32b",
  "provider": {
    "groq": {
      "api": "https://api.groq.com/openai/v1"
    }
  }
}

📖 Full Free Models Guide

🎨 Features

🔒 Smart Permissions

Configure granular permissions for commands:

{
  "permission": {
    "bash": {
      "git push *": "ask",
      "rm -rf *": "deny",
      "npm install *": "ask",
      "*": "ask"
    }
  }
}

• allow - Auto-execute
• ask - Require approval (default)
• deny - Block completely

🔌 MCP Integration

5 pre-configured MCP servers out of the box:

• Filesystem - Local file operations
• Git - Repository analysis and operations
• Sequential Thinking - Step-by-step reasoning
• Fetch - Web content retrieval
• Memory - Knowledge graph persistence

Customize in ~/.opencode/config.json:

{
  "mcp": {
    "filesystem": { "enabled": true },
    "git": { "enabled": true },
    "sequential-thinking": { "enabled": true }
  }
}

🏗️ Project Templates

Quick start with pre-configured projects:

glimx init --list                    # List templates
glimx init react-vite my-app        # React + Vite + TailwindCSS
glimx init node-typescript my-api   # Node.js + TypeScript
glimx init python-fastapi backend   # Python + FastAPI

📊 Analytics

Glimx collects anonymous usage data to help us improve the product. This data includes:

• Command usage statistics
• Feature adoption rates
• Performance metrics
• Error reporting (without sensitive data)

All data is anonymous and cannot be used to identify individual users.

glimx analytics status   # Check current status
glimx analytics disable  # Opt out of analytics
glimx analytics enable   # Opt back in

You can also disable analytics by setting analytics: false in your configuration file:

{
  "analytics": false
}

🔄 Checkpoints & Rollback

Glimx provides powerful checkpoint and rollback functionality to save your progress and revert changes when needed.

# Create a checkpoint
glimx checkpoint create "Before major refactor"

# List checkpoints
glimx checkpoint list

# Rollback to a checkpoint
glimx checkpoint rollback [checkpoint-id]

# Rollback to a specific message
glimx rollback message [message-id]

# List available rollback points
glimx rollback list

📚 Documentation

• Installation Guide
• Free Models Guide
• Configuration Guide
• MCP Integration
• Tools & Commands
• Usage Examples
• Troubleshooting
• Analytics

🆚 Why Glimx?

| Feature | Glimx | GitHub Copilot | Cursor | |---------|-------|----------------|--------| | Price | 🟢 Free (with free models) | 💰 $10/month | 💰 $20/month | | Terminal-based | ✅ | ❌ | ❌ | | Multiple AI Models | ✅ 20+ models | ❌ GPT only | ⚠️ Limited | | MCP Support | ✅ 5 built-in | ❌ | ❌ | | Open Source | ✅ | ❌ | ❌ | | Smart Permissions | ✅ | ❌ | ❌ | | Offline Mode | ⚠️ API required | ❌ | ❌ |

🐛 Troubleshooting

Common Issues

API key not found:

echo $GROQ_API_KEY  # Verify key is set
echo 'export GROQ_API_KEY="your-key"' >> ~/.zshrc
source ~/.zshrc

Permission denied:

cat ~/.opencode/config.json  # Check config
rm ~/.opencode/config.json   # Reset to defaults

MCP server failed:

which uvx  # Check if uvx available
curl -LsSf https://astral.sh/uv/install.sh | sh  # Install uv

📖 Full Troubleshooting Guide

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

git clone https://github.com/codelabs-poliwangi/glimx-cli.git
cd glimx-cli
bun install
cd packages/opencode
bun run dev

📜 License

MIT License - see LICENSE

Based on OpenCode with significant enhancements.

🌟 Credits

• Built on OpenCode's proven architecture
• Powered by Model Context Protocol (MCP)
• Uses Bun for ultra-fast runtime
• UI powered by OpenTUI

💬 Community

• 🐛 Report Issues
• 💬 Discussions
• ⭐ Star on GitHub
• 📧 Email: [email protected]

Built with 💜 by CodeLabs Poliwangi

⭐ Star • 🐛 Report Bug • ✨ Request Feature