lumecode

✨ Features

📦 Installation

Homebrew (macOS)

brew install anonymus-netizien/lumecode/lumecode

Binary Download

# macOS (Apple Silicon)
curl -L https://github.com/anonymus-netizien/lumecode/releases/latest/download/lumecode-darwin-arm64.tar.gz | tar xz

# macOS (Intel)
curl -L https://github.com/anonymus-netizien/lumecode/releases/latest/download/lumecode-darwin-amd64.tar.gz | tar xz

# Linux
curl -L https://github.com/anonymus-netizien/lumecode/releases/latest/download/lumecode-linux-amd64.tar.gz | tar xz

Docker

docker pull ghcr.io/anonymus-netizien/lumecode:latest
docker run -it -e LUMECODE_API_KEY=$OPENAI_API_KEY ghcr.io/anonymus-netizien/lumecode

From Source

git clone https://github.com/anonymus-netizien/lumecode.git
cd lumecode
go build -o lumecode ./cmd/lumecode

🚀 Usage

Quick Start

# Set your API key
export LUMECODE_PROVIDER=openai
export LUMECODE_API_KEY=sk-...

# Run interactive mode
lumecode

# Analyze a project
lumecode analyze ./my-project

# Generate code
lumecode generate "Create a REST API with user authentication"

# Review code
lumecode review ./src/main.go

Examples

# Use different providers
LUMECODE_PROVIDER=anthropic lumecode
LUMECODE_PROVIDER=ollama LUMECODE_MODEL=llama2 lumecode

# Custom model
LUMECODE_MODEL=gpt-4-turbo lumecode

⚙️ Configuration

Environment Variables

LUMECODE_PROVIDER=openai      # openai, anthropic, groq, gemini, deepseek, ollama
LUMECODE_API_KEY=sk-...       # Your API key
LUMECODE_MODEL=gpt-4          # Model to use
LUMECODE_LOG_LEVEL=info       # debug, info, warn, error

Config File

Create ~/.lumecode/config.toml:

[provider]
name = "openai"
model = "gpt-4"

[logging]
level = "info"

🏗️ Architecture

lumecode/
├── cmd/lumecode/       # CLI entry point
├── internal/
│   ├── agent/          # AI agents (analyzer, coder, reviewer, etc.)
│   ├── llm/            # LLM providers & tools
│   ├── workspace/      # Project analysis & indexing
│   ├── tui/            # Terminal UI
│   └── config/         # Configuration
├── pkg/                # Public packages
└── tests/              # Test suites

📚 Documentation

🧪 Development

# Run tests
go test ./tests/...

# Run with coverage
go test -cover ./...

# Build
go build -o lumecode ./cmd/lumecode

# Lint
golangci-lint run

🤝 Contributing

Contributions are welcome! Please read the Contributing Guide first.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing)
5. Open a Pull Request

📄 License

MIT License - see LICENSE for details.