KrutrimConnect
Connect Codex and OpenCode to Krutrim Cloud models with secure sign-in, model selection and reversible configuration.
Overview
KrutrimConnect connects Codex and OpenCode to Krutrim Cloud inference. It handles API-key sign-in, model selection and coding-tool configuration, and restores your saved configuration when you disconnect.
Install KrutrimConnect.
Sign in with your API key.
Choose a model from the catalogue.
Connect Codex or OpenCode.
Before you begin
You need a Krutrim Cloud API key and Codex or OpenCode installed separately. KrutrimConnect includes its own runtime; Node.js, npm and administrator access are not required.
Download the latest release · Source and user guide
Installation
Run this in your terminal:
(
set -eu
connect_installer="$(mktemp)"
trap 'rm -f "$connect_installer"' EXIT
curl --proto '=https' --proto-redir '=https' -fsSL \
https://raw.githubusercontent.com/ola-krutrim/krutrimconnect/main/install.sh \
-o "$connect_installer"
sh "$connect_installer"
)The installer downloads the latest stable release, verifies its checksum and installs KrutrimConnect for your user. Available archives cover macOS Apple Silicon, macOS Intel, Linux x64 with glibc and Alpine Linux x64 with musl. The installer selects the matching glibc or musl archive automatically.
Run in PowerShell 5.1 or later:
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/ola-krutrim/krutrimconnect/main/install.ps1" -OutFile "$env:TEMP\krutrimconnect-install.ps1"
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\krutrimconnect-install.ps1"
$env:Path = "$env:LOCALAPPDATA\KrutrimConnect\bin;$env:Path"
krutrimconnect --versionWindows x64 installs under %LOCALAPPDATA%\KrutrimConnect and uses Windows Credential Manager.
Get started
Sign in
Create or manage your API key, then run:
Paste the API key at the masked prompt. Login validates the key without inference and stores it in your OS keychain.
Credential storage
The OS keychain is the default.
Windows requires Credential Manager and does not allow the plaintext fallback.
For automated input, krutrimconnect login --from-env reads KRUTRIM_API_KEY, or krutrimconnect login --stdin reads a key piped from your secret manager. Ordinary commands do not implicitly use an ambient environment key. Disconnect tools before replacing a stored key.
Command reference
Every command starts with krutrimconnect. Use krutrimconnect COMMAND --help for options.
Account and credentials
login
Validate and store your API key.
auth status
Show local credential status without displaying the key.
logout --disconnect
Restore connected tools and remove accessible local credentials.
Models
models list
List catalogue models, with live lookup and snapshot fallback.
models show MODEL_ID
Show details from the bundled catalogue.
Model listing supports query, publisher and modality filters. See command help for JSON output where supported.
Coding tools
codex on --model MODEL_ID
Connect Codex to the selected model.
codex off
Restore the saved Codex configuration.
status
Show the Codex connection state.
opencode on --model MODEL_ID
Connect OpenCode to the selected model.
opencode off
Restore the saved OpenCode configuration.
opencode status
Show the OpenCode connection state.
opencode run [args...]
Launch OpenCode and forward arguments.
chat --model MODEL_ID --accept-inference-charges
Send a potentially billable prompt directly to Krutrim.
Maintenance
doctor
Check configuration, credentials, reachability and recorded capabilities without inference.
upgrade --check
Check for a newer stable release.
upgrade
Download and install the latest stable release.
uninstall
Restore managed configurations, remove accessible credentials and remove the CLI.
--version
Print the installed version.
--help
Show command help.
Upgrade or remove
Upgrade
Restart coding-tool sessions after upgrading, then reconnect tools to update their stored runtime references. Older runtimes are retained for existing sessions.
Log out
To disconnect tools and remove local credentials while keeping the CLI:
Uninstall
To remove KrutrimConnect and its managed connections and credentials:
On Windows, close older KrutrimConnect sessions before uninstalling. Executable cleanup finishes after the uninstall command exits.
Troubleshooting
If activation fails, check the exact model ID, API-key validation and diagnostics. Model availability alone does not establish coding-tool compatibility.
If configuration changed outside KrutrimConnect, review the reported changes before forcing restoration. Keep your backups and do not delete configuration or credential-helper paths to bypass ownership checks.
Report an issue with redacted diagnostics. Follow the project's security guidance for vulnerabilities.
Terms and licence
KrutrimConnect source is licensed under Apache 2.0, with third-party notices. Krutrim Cloud use is governed by its Terms & Conditions and Privacy Policy. Review and test AI-generated output before use.
Last updated

