Lora Code

Enterprise-Grade AI Coding Assistant for Your Terminal

Features • Installation • Quick Start • Usage • Configuration • Documentation

Overview

Lora Code is a powerful AI-driven command-line coding assistant that seamlessly integrates into your development workflow. Built for professional developers and teams, it provides intelligent code suggestions, automated refactoring, and comprehensive project understanding directly from your terminal.

Features

Core Capabilities

Feature	Description
🤖 AI-Powered Coding	Intelligent code generation, refactoring, and explanations
🏗️ Architect Mode	Design-first approach with separate architect and editor models
📊 Context Mode	Automatic identification of relevant files for your task
💬 Ask Mode	Query your codebase without making changes
🗺️ Repository Mapping	Intelligent codebase understanding with customizable token limits
🔄 Git Integration	Automatic commits, diffs, and version control management

Advanced Features

Feature	Description
🎤 Voice Input	Record and transcribe voice commands (WAV, MP3, WebM)
💾 Checkpoints	Save and restore session states
🪝 Hooks System	Custom automation triggers for various events
✅ Auto-Approve	Configurable automatic approval for different action categories
🌐 Web Scraping	Fetch and analyze web content with Playwright support
🔐 Authentication	Secure device-flow authentication with credential caching
🌍 Multi-Language UI	Interface available in English and Turkish
📋 Clipboard Integration	Paste images and text directly into chat

Developer Experience

Feature	Description
🎨 Syntax Highlighting	Customizable code themes (One Dark, Monokai, Solarized, etc.)
⌨️ VI Mode	Optional VI editing mode in terminal
📝 Multi-line Input	Extended input mode with Meta-Enter submission
🔔 Notifications	Terminal bell or custom command notifications
🧪 Auto-Testing	Automatic test execution after changes
🔍 Auto-Linting	Automatic linting with configurable commands

Installation

Requirements

Python 3.10 or higher
Git (recommended)
FFmpeg (optional, for MP3/WebM voice recording)

Install via pip

pip install loracode

Install from Source

git clone https://github.com/Lora-Technologies/loracode.git
cd loracode
pip install -e .

Upgrade

# Upgrade to latest stable version
loracode --upgrade

# Install from main branch (development)
loracode --install-main-branch

Quick Start

1. Authentication

# Interactive login with device flow
loracode
# Then use: /auth login

# Or set API key directly
export LORA_CODE_API_KEY="your-api-key"

2. Start a Session

# Start interactive session
loracode

# Work with specific files
loracode src/main.py src/utils.py

# Use a specific model
loracode --model gpt-4

# Single message mode (non-interactive)
loracode -m "Add error handling to main.py"

Usage

Chat Modes

Mode	Command	Description
Code	`/code`	Make code changes (default)
Architect	`/architect`	Design changes with architect model, implement with editor
Ask	`/ask`	Ask questions without making changes
Context	`/context`	Auto-identify files needed for a task
Help	`/help`	Get help about Lora Code usage

In-Session Commands

File Management

Command	Description
`/add <file>`	Add file(s) to the editable session
`/drop [file]`	Remove file(s) from session (all if no argument)
`/read-only <file>`	Add file(s) as read-only reference
`/ls`	List all files in session and repository

Git Operations

Command	Description
`/commit [message]`	Commit pending changes
`/diff`	Show changes since last commit
`/undo`	Undo the last Lora Code commit
`/git <command>`	Run any git command

Session Management

Command	Description
`/clear`	Clear conversation history
`/reset`	Clear history and drop all files
`/tokens`	Show token usage breakdown
`/settings`	Display current configuration

Model Configuration

Command	Description
`/model [name]`	Switch or display current model
`/editor-model <name>`	Set the editor model
`/weak-model <name>`	Set the weak model (for summaries)
`/think-tokens [value]`	Set thinking token budget
`/chat-mode <mode>`	Switch chat mode

Checkpoints

Command	Description
`/checkpoint-save [name]`	Save current session state
`/checkpoint-load <name>`	Restore a saved session
`/checkpoints`	List all saved checkpoints
`/checkpoint delete <name>`	Delete a checkpoint

Automation

Command	Description
`/auto-approve <categories>`	Auto-approve specific action categories
`/auto-reject <categories>`	Auto-reject specific action categories
`/auto-ask <categories>`	Reset categories to ask mode
`/auto-status`	Show current auto-approval settings
`/hooks`	List and manage automation hooks

Utilities

Command	Description
`/web <url>`	Fetch and add web content to chat
`/voice`	Record voice input (requires OpenAI API key)
`/paste`	Paste clipboard content (text or image)
`/copy`	Copy last assistant message to clipboard
`/copy-context`	Copy current context for external use
`/editor`	Open external editor for input
`/run <command>`	Execute shell command
`/test [command]`	Run tests
`/lint`	Lint and fix files
`/map`	Show repository map
`/report`	Report an issue on GitHub
`/language [code]`	Change UI language (en/tr)
`/auth <login\|logout\|status>`	Manage authentication
`/help [topic]`	Get help on specific topics
`/quit`	Exit Lora Code

Configuration

Configuration Files

Lora Code searches for configuration in the following order:

Command line arguments (highest priority)
Environment variables (prefixed with LORACODE_)
.loracode.conf.yml in current directory
.loracode.conf.yml in git root
.loracode.conf.yml in home directory

Configuration File Example

# .loracode.conf.yml

# Model Configuration
model: gpt-4
weak-model: gpt-3.5-turbo
editor-model: gpt-4
edit-format: architect
thinking-tokens: 8096

# API Settings
api-base: https://api.loratech.dev

# Git Settings
auto-commits: true
dirty-commits: true
attribute-co-authored-by: true
git-commit-verify: false

# UI Settings
dark-mode: true
pretty: true
stream: true
code-theme: one-dark
vim: false
multiline: false
notifications: false

# Repository Map
map-tokens: 2048
map-refresh: auto

# Automation
auto-lint: true
auto-test: false
suggest-shell-commands: true

# Language
language: en
chat-language: null
commit-language: null

# Voice Settings
voice-format: wav
voice-language: en

Environment Variables

Variable	Description
`LORA_CODE_API_KEY`	API key for Lora Code services
`LORA_CODE_API_BASE`	Custom API base URL
`LORACODE_MODEL`	Default model to use
`LORACODE_DARK_MODE`	Enable dark mode (true/false)
`LORACODE_AUTO_COMMITS`	Enable auto-commits (true/false)

CLI Arguments Reference

Main Model Settings

--model MODEL              # Main chat model
--weak-model MODEL         # Model for summaries and commits
--editor-model MODEL       # Model for editor tasks
--edit-format FORMAT       # Edit format (diff, whole, architect, etc.)
--architect                # Use architect edit format
--thinking-tokens VALUE    # Thinking token budget (0 to disable)

API Settings

--api-key KEY              # Lora Code API key
--api-base URL             # API base URL
--timeout SECONDS          # API call timeout
--verify-ssl / --no-verify-ssl  # SSL verification

Cache Settings

--cache-prompts / --no-cache-prompts  # Enable prompt caching
--cache-keepalive-pings N             # Keep cache warm (ping count)

Repository Map

--map-tokens N             # Token limit for repo map (0 to disable)
--map-refresh MODE         # Refresh mode: auto, always, files, manual
--map-multiplier-no-files N  # Multiplier when no files specified

Git Settings

--git / --no-git           # Enable/disable git integration
--auto-commits / --no-auto-commits  # Auto-commit changes
--dirty-commits / --no-dirty-commits  # Commit with dirty repo
--attribute-co-authored-by / --no-attribute-co-authored-by  # Co-author attribution
--commit-prompt PROMPT     # Custom commit message prompt
--dry-run                  # Preview changes without applying

Output Settings

--dark-mode / --light-mode  # Color scheme
--pretty / --no-pretty      # Colorized output
--stream / --no-stream      # Streaming responses
--code-theme THEME          # Syntax highlighting theme
--show-diffs                # Show diffs when committing

Voice Settings

--voice-format FORMAT      # Audio format: wav, mp3, webm
--voice-language LANG      # ISO 639-1 language code
--voice-input-device NAME  # Input device name

Checkpoint Settings

--load-checkpoint NAME     # Load checkpoint at startup
--save-on-exit [NAME]      # Save checkpoint on exit
--checkpoint-dir DIR       # Custom checkpoint directory

Automation

--auto-approve CATEGORIES  # Auto-approve categories (comma-separated)
--auto-reject CATEGORIES   # Auto-reject categories
--yes-always               # Always confirm prompts
--lint-cmd "LANG: CMD"     # Custom lint command per language
--test-cmd CMD             # Test command
--auto-lint / --no-auto-lint  # Auto-lint after changes
--auto-test / --no-auto-test  # Auto-test after changes

Modes

-m, --message MSG          # Single message mode
-f, --message-file FILE    # Message from file
--gui                      # Browser-based interface
--copy-paste               # Auto copy/paste with web UI
--watch-files              # Watch for AI coding comments

Other Options

--vim                      # VI editing mode
--multiline                # Multi-line input mode
--fancy-input / --no-fancy-input  # Input with history/completion
--notifications            # Enable notifications
--detect-urls              # Auto-detect URLs in input
--language LANG            # UI language (en, tr)
--encoding ENCODING        # I/O encoding (default: utf-8)
--verbose                  # Verbose output
--version                  # Show version
--help                     # Show help

Hooks System

Hooks allow you to run custom commands at specific events during your Lora Code session.

Configuration

Create .loracode/settings.json in your project root:

{
  "hooks": {
    "BeforeTool": [
      {
        "name": "pre-edit-check",
        "command": "python scripts/validate.py",
        "description": "Validate before making changes",
        "timeout": 5000
      }
    ],
    "AfterTool": [
      {
        "name": "post-edit-format",
        "command": "black .",
        "description": "Format code after changes"
      }
    ]
  }
}

Hook Events

Event	Trigger
`BeforeTool`	Before any tool execution
`AfterTool`	After tool execution

Managing Hooks

/hooks                    # List all hooks
/hooks enable <name>      # Enable a hook
/hooks disable <name>     # Disable a hook
/hooks test <name>        # Test a hook

Auto-Approval System

Control which actions require confirmation:

Usage

# Auto-approve specific categories
/auto-approve file_edit,lint_fix

# Auto-approve everything
/auto-approve all

# Auto-reject categories
/auto-reject shell_command

# Reset to ask mode
/auto-ask all

# View current settings
/auto-status

Authentication

Lora Code uses secure device-flow authentication:

# Start login process
/auth login

# Check authentication status
/auth status

# Logout
/auth logout

Credentials are securely cached locally. Use --no-cache-credentials to disable caching.

Project Structure

loracode/
├── loracode/           # Main package
│   ├── coders/         # Edit format implementations
│   ├── locales/        # i18n translations
│   ├── resources/      # Model settings and assets
│   ├── main.py         # Entry point
│   ├── commands.py     # In-session commands
│   ├── args.py         # CLI argument parsing
│   └── ...
├── tests/              # Test suite
├── requirements/       # Dependency specifications
├── scripts/            # Utility scripts
└── docs/               # Documentation

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Clone the repository
git clone https://github.com/Lora-Technologies/loracode.git
cd loracode

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
flake8 loracode tests

Security

For security concerns, please see our Security Policy or contact security@loratech.dev.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Support

Channel	Link
📧 Email	support@loratech.dev
🐛 Issues	GitHub Issues
💬 Discussions	GitHub Discussions
📖 Documentation	docs.loratech.dev

_{Built with ❤️ by Lora Technologies}

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
.github		.github
loracode		loracode
requirements		requirements
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
pyproject.toml		pyproject.toml

Category	Description
`file_create`	Creating new files
`file_edit`	Editing existing files
`shell_command`	Running shell commands
`url_add`	Adding URLs to chat
`lint_fix`	Applying lint fixes
`test_fix`	Applying test fixes
`git_repo`	Git operations
`analytics`	Analytics collection

License

Lora-Technologies/LoraCode

Folders and files

Latest commit

History

Repository files navigation

Lora Code

Overview

Features

Core Capabilities

Advanced Features

Developer Experience

Installation

Requirements

Install via pip

Install from Source

Upgrade

Quick Start

1. Authentication

2. Start a Session

Usage

Chat Modes

In-Session Commands

File Management

Git Operations

Session Management

Model Configuration

Checkpoints

Automation

Utilities

Configuration

Configuration Files

Configuration File Example

Environment Variables

CLI Arguments Reference

Main Model Settings

API Settings

Cache Settings

Repository Map

Git Settings

Output Settings

Voice Settings

Checkpoint Settings

Automation

Modes

Other Options

Hooks System

Configuration

Hook Events

Managing Hooks

Auto-Approval System

Categories

Usage

Authentication

Project Structure

Contributing

Development Setup

Security

License

Support

About

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Languages

Packages