Package Exports

megallm
megallm/src/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (megallm) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

MegaLLM Setup Tool

🚀 A powerful NPX package to configure Claude Code and Codex to use MegaLLM AI service with a single command.

🎯 Features

Auto-detection of installed AI tools (Claude Code, Codex/Windsurf)
OS-aware configuration for macOS, Linux, and Windows
Interactive setup with user-friendly prompts
Project or system-level configuration options
Automatic backup of existing configurations
Environment variable management
Shell configuration updates

📦 Installation & Usage

No installation required! Simply run:

npx megallm

Or install globally:

npm install -g megallm
megallm

🔧 What It Does

The MegaLLM setup tool will:

Detect your operating system and shell environment
Check for installed tools (Claude Code, Codex)
Prompt for configuration choices:
- Which tool to configure (Claude Code/Codex/Both)
- Setup level (System-wide or Project-specific)
- Your MegaLLM API key
Configure the selected tools with:
- Base URL: https://ai.megallm.io
- Your API key
- Proper authentication settings
Update environment variables (for system-level setup)
Reload shell configuration automatically

📋 Configuration Details

Claude Code Configuration

System-level (applies to all projects):

Location: ~/.claude/settings.json
Sets environment variables:
- ANTHROPIC_BASE_URL=https://ai.megallm.io
- ANTHROPIC_API_KEY=<your-api-key>

Project-level (current project only):

Location: .claude/settings.json or .claude/settings.local.json
Configuration is project-specific

Codex Configuration

System-level (applies to all projects):

Location: ~/.codex/config.toml
Configures API settings in TOML format

Project-level (current project only):

Location: .codex/config.toml
Configuration is project-specific

🖥️ Supported Platforms

macOS (10.14+)
Linux (Ubuntu, Debian, Fedora, Arch, etc.)
Windows (10/11 with PowerShell or CMD)

🚀 Quick Start Guide

Get your MegaLLM API key from https://megallm.io
Install Claude Code or Codex:
- Claude Code: https://claude.ai/code
- Windsurf (includes Codex): https://codeium.com/windsurf
Run the setup tool:
```
npx megallm
```
Follow the interactive prompts:
- Select which tool to configure
- Choose system or project level setup
- Enter your API key
- Confirm the configuration
Start using your AI tools with MegaLLM!

🔐 Security

API keys are stored securely in configuration files
Backup files are created before any modifications
Project-level configs can be added to .gitignore
The last 20 characters of API keys are approved for Claude Code

🛠️ Advanced Usage

Command Line Options

# Run with debug output
DEBUG=* npx megallm

# Skip banner
NO_BANNER=1 npx megallm

Manual Configuration

If you prefer manual setup, you can edit the configuration files directly:

Claude Code (~/.claude/settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "your-api-key-here"
  },
  "customApiKeyResponses": {
    "approved": ["last-20-chars-of-key"],
    "rejected": []
  }
}

Codex (~/.codex/config.toml):

[api]
base_url = "https://ai.megallm.io"
api_key = "your-api-key-here"
provider = "custom"

[auth]
provider = "custom"
endpoint = "https://ai.megallm.io"
api_key = "your-api-key-here"

🐛 Troubleshooting

Tool not detected

Ensure Claude Code or Codex is properly installed
Check that the configuration directories exist:
- Claude: ~/.claude/
- Codex: ~/.codex/

Configuration not applied

Restart your terminal after setup
For project-level configs, ensure you're in the correct directory
Check file permissions on configuration files

API key issues

Ensure your API key is valid and active
Check for spaces or special characters
Verify the key has proper permissions on MegaLLM

📚 Documentation

MegaLLM Documentation: https://megallm.io/docs
Claude Code Docs: https://docs.claude.com/claude-code
Codex/Windsurf Docs: https://docs.codeium.com

🤝 Contributing

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

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

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

💬 Support

Email: support@megallm.io
GitHub Issues: https://github.com/megallm/megallm/issues
Discord: Join our community

🙏 Acknowledgments

Built with ❤️ by the MegaLLM team
Powered by Node.js and NPM
Special thanks to all contributors

Made with 🚀 by MegaLLM