envClaudeSet - Environment Configuration Tool

Quick Start • Features • How It Works

🎯 Quick Start

npx envclaudeset@latest

That's it! The interactive CLI will guide you through the entire setup process.

✨ Features

🔍 Smart Detection

• Auto-detects installed AI tools
• Identifies your OS and shell
• Checks existing configurations

🔧 Automated Setup

• Interactive configuration wizard
• Custom API endpoint support
• Environment variable management

🔐 Secure & Safe

• Automatic configuration backups
• Secure API key storage
• Project-level isolation support

🌍 Universal Support

• Works on macOS, Linux, Windows
• Supports bash, zsh, fish, PowerShell
• System or project-level configs

📊 How It Works

🔄 Setup Process Flow

┌──────────────────────────────────────────────────────┐
│                   npx envclaudeset                   │
└────────────────────────┬─────────────────────────────┘
                         ▼
┌──────────────────────────────────────────────────────┐
│          🔍 Environment Detection                    │
├──────────────────────────────────────────────────────┤
│  • Operating System (Mac/Linux/Win)                  │
│  • Shell Type (bash/zsh/fish/PS)                     │
│  • Installed Tools (Claude/Codex)                    │
└────────────────────────┬─────────────────────────────┘
                         ▼
┌──────────────────────────────────────────────────────┐
│          🔗 Custom API Endpoint                      │
├──────────────────────────────────────────────────────┤
│  Default: http://nhatsangdev.tech:8317               │
│  Or enter your own custom endpoint                   │
└────────────────────────┬─────────────────────────────┘
                         ▼
┌──────────────────────────────────────────────────────┐
│          🔑 API Key Setup                            │
├──────────────────────────────────────────────────────┤
│  Enter your API key securely                         │
└────────────────────────┬─────────────────────────────┘
                         ▼
┌──────────────────────────────────────────────────────┐
│          ⚙️ Configuration Choice                     │
├──────────────────────────────────────────────────────┤
│  Tool Selection:                                     │
│    • Claude Code only                                │
│    • Codex/Windsurf only                             │
│    • OpenCode only                                   │
│    • Multiple tools                                  │
│                                                      │
│  Scope:                                              │
│    • System-wide (all projects)                      │
│    • Project-specific (current only)                 │
└────────────────────────┬─────────────────────────────┘
                         ▼
┌──────────────────────────────────────────────────────┐
│          ✅ Apply & Verify                           │
├──────────────────────────────────────────────────────┤
│  • Write configuration files                         │
│  • Set environment variables                         │
│  • Verify setup                                      │
└──────────────────────────────────────────────────────┘

🛠️ Supported Tools

Claude Code

AI-powered coding assistant with advanced capabilities

Codex / Windsurf

OpenAI Codex integration for code generation

OpenCode

Open-source AI coding assistant

🌟 Features in Detail

Custom API Endpoints

• Configure any OpenAI-compatible API endpoint
• Default endpoint pre-configured for quick start
• Full URL validation and error checking

Flexible Configuration

• System-level: Apply settings globally for all projects
• Project-level: Isolate settings to specific projects
• Easy switching between configurations

Environment Management

• Automatic environment variable setup
• Shell profile integration (bash, zsh, fish, PowerShell)
• Safe variable removal and cleanup

Smart Detection

• Identifies installed AI tools automatically
• Detects existing configurations
• Offers upgrade or override options

💻 Requirements

• Node.js >= 18.0.0
• One or more supported AI tools (Claude Code, Codex, or OpenCode)

📝 Configuration Files

Claude Code

• System: ~/.claude/settings.json
• Project: .claude/settings.json
• API Keys: ~/.claude.json

Codex

• System: ~/.codex/config.toml

OpenCode

• System: ~/.config/opencode/opencode.json
• Project: opencode.json

🔒 Security

• API keys are stored securely
• Masked display in terminal
• Project-level configs can be gitignored
• No credentials transmitted externally

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

Built to simplify AI coding tool configuration with custom endpoints.