Christian Schindler chrishdx
0 Followers · 0 Following
  • Joined on 2024-02-09
Repositories
2
 Projects
2
 Packages Public Activity Starred Repositories

@chrishdx/llm-dev-server (1.2.9)

Published 2026-01-11 12:06:32 +01:00 by chrishdx

Installation

@chrishdx:registry=
npm install @chrishdx/llm-dev-server@1.2.9
"@chrishdx/llm-dev-server": "1.2.9"

About this package

LLM Dev Server

A unified Multi-LLM Development Server supporting Claude, Codex, and Gemini. Provides a web-based interface to interact with multiple AI coding assistants from a single dashboard.

Features

  • 🤖 Multi-LLM Support: Claude (Anthropic), Codex (OpenAI), Gemini (Google)
  • 💬 Unified Chat Interface: Single UI to interact with all providers
  • 📁 File Operations: AI-assisted file management and editing
  • 🔒 Authentication: Built-in user management with JWT
  • 🔄 Token Management: Automatic credential refresh
  • 🏠 Local Data Storage: All data stored in ~/.dev_server

Installation

npm install -g @chrishdx/llm-dev-server

Quick Start

# Start the server (first run initializes configuration)
llm-dev-server

# Or with custom port
llm-dev-server start --port 8080

On first run, the server will:

  1. Create ~/.dev_server directory
  2. Generate a configuration file at ~/.dev_server/.env
  3. Create an admin user (credentials shown in console)
  4. Start the web server at http://localhost:3000

Commands

llm-dev-server              # Start server (default)
llm-dev-server start        # Start server
llm-dev-server init         # Initialize configuration only
llm-dev-server config       # Show current configuration
llm-dev-server help         # Show help

Configuration

All configuration is stored in ~/.dev_server/.env:

# Server Settings
NODE_ENV=production
PORT=3000
LOG_LEVEL=info

# Security (auto-generated)
JWT_SECRET=your-jwt-secret
ENCRYPTION_KEY=your-encryption-key

# CORS
ALLOWED_ORIGINS=http://localhost:3000

# Proxy Settings (for reverse proxy)
# TRUST_PROXY=true

# Authelia SSO (optional)
# AUTHELIA_ENABLED=false
# AUTHELIA_ADMIN_GROUPS=admins

Data Directory Structure

~/.dev_server/
├── .env                    # Configuration file
├── data/
│   ├── dev-server.db      # SQLite database
│   ├── claude/            # Claude credentials & cache
│   ├── codex/             # Codex credentials
│   └── gemini/            # Gemini credentials
├── workspaces/            # Project workspaces
└── logs/                  # Server logs

Environment Variables

Variable Default Description
DEV_SERVER_HOME ~/.dev_server Base directory for all data
PORT 3000 Server port
NODE_ENV production Environment mode
JWT_SECRET auto-generated JWT signing secret
ENCRYPTION_KEY auto-generated Data encryption key
ALLOWED_ORIGINS http://localhost:3000 CORS allowed origins
TRUST_PROXY false Trust reverse proxy headers
LOG_LEVEL info Logging level

LLM Provider Setup

Claude (Anthropic)

  1. Navigate to Settings > Providers in the web UI
  2. Click "Login with Claude"
  3. Follow the OAuth flow to authenticate

Codex (OpenAI)

  1. Navigate to Settings > Providers
  2. Click "Login with Codex"
  3. Authenticate via browser

Gemini (Google)

  1. Navigate to Settings > Providers
  2. Click "Login with Gemini"
  3. Complete Google OAuth

Development

# Clone repository
git clone https://github.com/chrishdx/llm-dev-server.git
cd llm-dev-server

# Install dependencies
npm install

# Run in development mode (with hot reload)
npm run dev

# Build for production
npm run build

# Run production build locally
npm start

API Endpoints

Endpoint Description
GET /api/health Health check
POST /api/auth/login User login
GET /api/conversations List conversations
POST /api/conversations Create conversation
POST /api/conversations/:id/messages Send message
GET /api/jobs List background jobs

Tech Stack

  • Backend: Node.js, Express, TypeScript, SQLite, Sequelize
  • Frontend: React, TypeScript, Material-UI, Vite
  • Auth: JWT, bcrypt
  • LLM SDKs: Claude Agent SDK, Codex SDK, Gemini CLI

Requirements

  • Node.js >= 20.0.0
  • npm >= 10.0.0

License

MIT © Christian Schindler

Dependencies

Dependencies

ID Version
@anthropic-ai/claude-agent-sdk ^0.1.76
@anthropic-ai/sdk ^0.71.2
@google/gemini-cli ^0.22.5
@openai/codex-sdk ^0.77.0
bcrypt ^5.1.1
cors ^2.8.5
dotenv ^16.4.1
express ^4.18.2
google-auth-library ^9.14.2
joi ^17.12.0
jsonwebtoken ^9.0.2
sequelize ^6.37.1
sqlite3 ^5.1.7
winston ^3.11.0

Development Dependencies

ID Version
@types/bcrypt ^5.0.2
@types/cors ^2.8.17
@types/express ^4.17.21
@types/jsonwebtoken ^9.0.5
@types/node ^20.11.10
concurrently ^8.2.2
nodemon ^3.0.3
ts-node ^10.9.2
typescript ^5.3.3

Keywords

llm claude codex gemini ai development-server ai-assistant coding-assistant anthropic openai google
Details
npm
2026-01-11 12:06:32 +01:00
1
Christian Schindler
Project Site
MIT
335 KiB
Assets (1)
llm-dev-server-1.2.9.tgz 335 KiB
Versions (2) View all
1.2.10 2026-01-11
1.2.9 2026-01-11