Config

icefort Config

A lightweight, cross-platform utility for reading, displaying, and safely editing local configuration files for generative AI CLIs including Claude Code CLI, OpenAI Codex, and Gemini CLI.

🚀 Quick Install & Run

✨ Features

- Multi-Engine Support: Manages configurations for Claude Code CLI, OpenAI Codex, and Gemini CLI
- Web Interface: Clean, intuitive browser-based configuration management
- Real-time Updates: File watching with live configuration updates
- Safe Editing: Automatic backups and JSON schema validation
- MCP Server Management: Complete MCP (Model Context Protocol) server configuration editing
- Color-coded Interface: Visual distinction between different AI engines
- Dark/Light Themes: Full theme support

📖 Usage Examples

Web Interface

Cross-Engine MCP Server Management

One of the key features is the ability to copy MCP server configurations between different AI engines and projects:

*Copy MCP servers from other engines (like Gemini CLI) or projects directly into any configuration*

🛠️ Installation Options

Via npm/npx (Recommended)

From Source

🎯 All Available Commands

🛠️ Development

Essential Commands

API Testing

Architecture

Core Service Pattern
The application uses a centralized CoreService that manages configuration state and acts as an event emitter. The web interface consumes this service:

- Web: Express server hosts CoreService and exposes REST API + Server-Sent Events

Engine Adapter System
New AI CLI tools are supported through the EngineAdapter interface. Each adapter implements:
- detect() - Check if configuration file exists
- read() - Parse configuration from disk
- validate(data) - JSON schema validation
- write(data) - Safe atomic writes with backup
- getConfigPath() - Resolve configuration file…