Same agent Smaller bill. The tools and infrastructure to get more work from your AI. Fewer tokens. Less compute. Lower cost.
TypeScript agent-harnessagent-harness-engineeringai-engineeringai-observabilityamd-gpuclaude-codeclickhousecodexcoding-agentcoding-agentscursorgenaigpu-monitoringllm-observabilityllmopsnvidia-smiobservabilityopen-sourceopenaiopentelemetry
// Package install implements `openlit coding install --vendor=...`.
//
// Writes per-vendor host plugin manifests to the user's home directory
// so the agent (Claude Code, Cursor, Codex, OpenCode) finds them on next
// launch. The manifest payloads themselves live under cli/internal/coding/install/marketplace/
// (mirrored from the repo-root `.claude-plugin/` + `plugins/` by
// `cli/scripts/sync-plugins.sh`) and are embedded into the binary at
// build time, so a single statically-linked CLI carries everything.
package install
import (
"errors"
"fmt"
"strings"
"github.com/spf13/cobra"
)
// NewCmd returns the cobra command for `openlit coding install`.
func NewCmd() *cobra.Command {
var (
vendor string
dryRun bool
)
cmd := &cobra.Command{
Use: "install",
Short: "Install per-vendor coding-agent host plugin manifests",
Long: `Install per-vendor host plugin manifests so coding agents pipe
telemetry through 'openlit coding hook'.
Vendors:
claude-code Plugin under ~/.claude/plugins/openlit-cc/ + 'claude plugin install'
cursor Hook entries merged into ~/.cursor/hooks.json (user scope)
codex Marketplace + 'codex plugin add openlit@openlit'
opencode Plugin under $XDG_CONFIG_HOME/opencode/plugins/ when set;
otherwise <user-home>/.config/opencode/plugins/
all shorthand for all four
The 'openlit' binary itself must be on PATH. Install via Homebrew, the
prebuilt binaries on GitHub Releases, the curl|sh installer, or
'go install github.com/openlit/openlit/cli/cmd/openlit@latest'.`,
SilenceUsage: true,
SilenceErrors: true,
RunE: func(cmd *cobra.Command, _ []string) error {
return run(cmd, vendor, dryRun)
},
}
cmd.Flags().StringVar(&vendor, "vendor", "", "Vendor (claude-code | cursor | codex | opencode | all)")
cmd.Flags().BoolVar(&dryRun, "dry-run", false, "Print what would be written without modifying any files")
_ = cmd.MarkFlagRequired("vendor")
return cmd
}
func run(cmd *cobra.Command, vendor string, dryRun bool) error {
vendor = strings.ToLower(strings.TrimSpace(vendor))
if vendor == "" {
return errors.New("--vendor is required")
}
targets, err := vendorsFromArg(vendor)
if err != nil {
return err
}
for _, v := range targets {
written, err := installVendor(v, dryRun)
if err != nil {
return fmt.Errorf("install %s: %w", v, err)
}
if dryRun {
fmt.Fprintf(cmd.OutOrStdout(), "[dry-run] would write %d file(s) for %s\n", len(written), v)
} else {
fmt.Fprintf(cmd.OutOrStdout(), "openlit: installed %s plugin (%d file(s))\n", v, len(written))
}
for _, p := range written {
fmt.Fprintf(cmd.OutOrStdout(), " - %s\n", p)
}
if !dryRun {
// Post-install hint: Codex is the only vendor whose
// hooks require explicit user trust on first run. Per
// Codex's security model the user has to open `/hooks`
// inside the TUI and review each plugin's hook entries
// once — otherwise the registered hooks stay listed
// but inactive, and nothing reaches OpenLit. Surfacing
// this here is the difference between "I installed and
// see no data" (bad) and a clean first session.
if v == "codex" {
fmt.Fprintln(cmd.OutOrStdout(), "")
fmt.Fprintln(cmd.OutOrStdout(), "Next steps for Codex:")
fmt.Fprintln(cmd.OutOrStdout(), " 1. Restart Codex (or run `codex` in a new shell).")
fmt.Fprintln(cmd.OutOrStdout(), " 2. Inside Codex, run `/hooks` and trust each `openlit@openlit` entry.")
fmt.Fprintln(cmd.OutOrStdout(), " 3. Start a session — your turns will appear in OpenLit's Coding Agents tab.")
}
}
}
return nil
}
// vendorsFromArg expands the --vendor argument into a slice of vendor IDs.
func vendorsFromArg(arg string) ([]string, error) {
switch arg {
case "all":
return []string{"claude-code", "cursor", "codex", "opencode"}, nil
case "claude-code", "cc":
return []string{"claude-code"}, nil
case "cursor":
return []string{"cursor"}, nil
case "codex":
return []string{"codex"}, nil
case "opencode":
return []string{"opencode"}, nil
default:
return nil, fmt.Errorf("unknown --vendor %q", arg)
}
}