feat: add Altimate provider with /login command and credential validation

suryaiyer95 · suryaiyer95 · commit bdc521753ae9 · 2026-03-17T11:32:54.000-07:00
diff --git a/docs/docs/getting-started.md b/docs/docs/getting-started.md
@@ -48,6 +48,18 @@ You can also configure connections manually — see [Warehouse connections](#war
 
 To set up your LLM provider, use the `/connect` command.
 
+### Connecting to Altimate
+
+If you have an Altimate account, you can connect directly:
+
+1. Run `/login` or select **Altimate** from the `/connect` provider list
+2. Enter your credentials:
+   - **Instance Name** — found in your Altimate URL: `https://<instance>.app.getaltimate.com` or `https://<instance>.app.myaltimate.com`
+   - **API Key** — go to **Settings > API Keys** in your Altimate dashboard and click **Copy**
+   - **URL** — defaults to `https://api.myaltimate.com` (use `https://api.getaltimate.com` for enterprise)
+
+Your credentials are validated against the server before being saved to `~/.altimate/altimate.json`. Once connected, Altimate AI is automatically selected as your default model.
+
 ## Configuration
 
 altimate uses a JSON config file. Create `altimate-code.json` in your project root or `~/.config/altimate-code/altimate-code.json` globally.
diff --git a/packages/opencode/src/cli/cmd/tui/app.tsx b/packages/opencode/src/cli/cmd/tui/app.tsx
@@ -10,6 +10,7 @@ import { Flag } from "@/flag/flag"
 import { Log } from "@/util/log"
 import { DialogProvider, useDialog } from "@tui/ui/dialog"
 import { DialogProvider as DialogProviderList } from "@tui/component/dialog-provider"
+import { DialogAltimateLogin } from "@tui/component/dialog-altimate-login"
 import { SDKProvider, useSDK } from "@tui/context/sdk"
 import { SyncProvider, useSync } from "@tui/context/sync"
 import { LocalProvider, useLocal } from "@tui/context/local"
@@ -580,6 +581,17 @@ function App() {
       },
       category: "Provider",
     },
+    {
+      title: "Login to Altimate",
+      value: "altimate.login",
+      category: "Provider",
+      slash: {
+        name: "login",
+      },
+      onSelect: () => {
+        dialog.replace(() => <DialogAltimateLogin />)
+      },
+    },
     {
       title: "View status",
       keybind: "status_view",
diff --git a/packages/opencode/src/cli/cmd/tui/component/dialog-altimate-login.tsx b/packages/opencode/src/cli/cmd/tui/component/dialog-altimate-login.tsx
@@ -0,0 +1,196 @@
+import { createSignal, Show, onMount } from "solid-js"
+import { createStore } from "solid-js/store"
+import { TextareaRenderable, TextAttributes } from "@opentui/core"
+import { useKeyboard } from "@opentui/solid"
+import { useDialog } from "@tui/ui/dialog"
+import { useSDK } from "../context/sdk"
+import { useSync } from "@tui/context/sync"
+import { useLocal } from "@tui/context/local"
+import { useTheme } from "../context/theme"
+import { AltimateApi } from "@/altimate/api/client"
+import { Filesystem } from "@/util/filesystem"
+
+export function DialogAltimateLogin() {
+  const dialog = useDialog()
+  const sdk = useSDK()
+  const sync = useSync()
+  const local = useLocal()
+  const { theme } = useTheme()
+  const [error, setError] = createSignal("")
+  const [validating, setValidating] = createSignal(false)
+  const [store, setStore] = createStore({
+    active: "instance" as "instance" | "key" | "url",
+  })
+
+  let instanceRef: TextareaRenderable
+  let keyRef: TextareaRenderable
+  let urlRef: TextareaRenderable
+
+  const fields = ["instance", "key", "url"] as const
+
+  function focusActive() {
+    setTimeout(() => {
+      const ref = { instance: instanceRef, key: keyRef, url: urlRef }[store.active]
+      if (ref && !ref.isDestroyed) ref.focus()
+    }, 1)
+  }
+
+  useKeyboard((evt) => {
+    if (evt.name === "tab") {
+      const idx = fields.indexOf(store.active)
+      const next = fields[(idx + 1) % fields.length]
+      setStore("active", next)
+      focusActive()
+      evt.preventDefault()
+    }
+    if (evt.name === "return") {
+      if (validating()) return
+      submit()
+    }
+  })
+
+  onMount(() => {
+    dialog.setSize("medium")
+    focusActive()
+  })
+
+  async function submit() {
+    const instance = instanceRef.plainText.trim()
+    const key = keyRef.plainText.trim()
+    const url = urlRef.plainText.trim().replace(/\/+$/, "")
+
+    if (!instance) {
+      setError("Instance name is required")
+      setStore("active", "instance")
+      focusActive()
+      return
+    }
+    if (!key) {
+      setError("API key is required")
+      setStore("active", "key")
+      focusActive()
+      return
+    }
+    if (!url) {
+      setError("URL is required")
+      setStore("active", "url")
+      focusActive()
+      return
+    }
+
+    setError("")
+    setValidating(true)
+    try {
+      const res = await fetch(`${url}/auth_health`, {
+        method: "GET",
+        headers: {
+          Authorization: `Bearer ${key}`,
+          "x-tenant": instance,
+        },
+      })
+      if (!res.ok) {
+        setError("Invalid credentials — check your instance name, API key, and URL")
+        return
+      }
+      const data = await res.json()
+      if (data.status !== "auth_valid") {
+        setError("Unexpected response from server")
+        return
+      }
+    } catch {
+      setError(`Connection failed — could not reach ${url}`)
+      return
+    } finally {
+      setValidating(false)
+    }
+
+    const creds = {
+      altimateUrl: url,
+      altimateInstanceName: instance,
+      altimateApiKey: key,
+    }
+    await Filesystem.writeJson(AltimateApi.credentialsPath(), creds, 0o600)
+    await sdk.client.instance.dispose()
+    await sync.bootstrap()
+    local.model.set({ providerID: "altimate-backend", modelID: "altimate-default" }, { recent: true })
+    dialog.clear()
+  }
+
+  return (
+    <box paddingLeft={2} paddingRight={2} gap={1}>
+      <box flexDirection="row" justifyContent="space-between">
+        <text attributes={TextAttributes.BOLD} fg={theme.text}>
+          Login to Altimate
+        </text>
+        <text fg={theme.textMuted} onMouseUp={() => dialog.clear()}>
+          esc
+        </text>
+      </box>
+
+      <text fg={theme.textMuted}>Find these in Settings &gt; API Keys in your Altimate dashboard</text>
+
+      <box>
+        <text fg={store.active === "instance" ? theme.text : theme.textMuted}>Instance Name:</text>
+        <text fg={theme.textMuted}>  From your URL: https://&lt;instance&gt;.app.myaltimate.com</text>
+        <textarea
+          height={3}
+          ref={(val: TextareaRenderable) => (instanceRef = val)}
+          placeholder="your-instance"
+          textColor={theme.text}
+          focusedTextColor={theme.text}
+          cursorColor={theme.text}
+          onMouseUp={() => {
+            setStore("active", "instance")
+            focusActive()
+          }}
+        />
+      </box>
+
+      <box>
+        <text fg={store.active === "key" ? theme.text : theme.textMuted}>API Key:</text>
+        <text fg={theme.textMuted}>  Settings &gt; API Keys &gt; Copy</text>
+        <textarea
+          height={3}
+          ref={(val: TextareaRenderable) => (keyRef = val)}
+          placeholder="your-api-key"
+          textColor={theme.text}
+          focusedTextColor={theme.text}
+          cursorColor={theme.text}
+          onMouseUp={() => {
+            setStore("active", "key")
+            focusActive()
+          }}
+        />
+      </box>
+
+      <box>
+        <text fg={store.active === "url" ? theme.text : theme.textMuted}>URL:</text>
+        <textarea
+          height={3}
+          ref={(val: TextareaRenderable) => (urlRef = val)}
+          initialValue="https://api.myaltimate.com"
+          placeholder="https://api.myaltimate.com"
+          textColor={theme.text}
+          focusedTextColor={theme.text}
+          cursorColor={theme.text}
+          onMouseUp={() => {
+            setStore("active", "url")
+            focusActive()
+          }}
+        />
+      </box>
+
+      <Show when={error()}>
+        <text fg={theme.error}>{error()}</text>
+      </Show>
+      <Show when={validating()}>
+        <text fg={theme.textMuted}>Validating credentials...</text>
+      </Show>
+
+      <text fg={theme.textMuted} paddingBottom={1}>
+        <span style={{ fg: theme.text }}>tab</span> next field{"  "}
+        <span style={{ fg: theme.text }}>enter</span> submit
+      </text>
+    </box>
+  )
+}
diff --git a/packages/opencode/src/cli/cmd/tui/component/dialog-provider.tsx b/packages/opencode/src/cli/cmd/tui/component/dialog-provider.tsx
@@ -13,6 +13,7 @@ import { DialogModel } from "./dialog-model"
 import { useKeyboard } from "@opentui/solid"
 import { Clipboard } from "@tui/util/clipboard"
 import { useToast } from "../ui/toast"
+import { DialogAltimateLogin } from "./dialog-altimate-login"
 
 const PROVIDER_PRIORITY: Record<string, number> = {
   opencode: 0,
@@ -21,6 +22,7 @@ const PROVIDER_PRIORITY: Record<string, number> = {
   "github-copilot": 3,
   anthropic: 4,
   google: 5,
+  "altimate-backend": 6,
 }
 
 export function createDialogProviderOptions() {
@@ -35,13 +37,18 @@ export function createDialogProviderOptions() {
         title: provider.name,
         value: provider.id,
         description: {
+          "altimate-backend": "(API key)",
           opencode: "(Recommended)",
           anthropic: "(API key)",
           openai: "(ChatGPT Plus/Pro or API key)",
           "opencode-go": "Low cost subscription for everyone",
         }[provider.id],
         category: provider.id in PROVIDER_PRIORITY ? "Popular" : "Other",
         async onSelect() {
+          if (provider.id === "altimate-backend") {
+            dialog.replace(() => <DialogAltimateLogin />)
+            return
+          }
           const methods = sync.data.provider_auth[provider.id] ?? [
             {
               type: "api",
diff --git a/packages/opencode/src/cli/cmd/tui/context/local.tsx b/packages/opencode/src/cli/cmd/tui/context/local.tsx
@@ -172,6 +172,15 @@ export const { use: useLocal, provider: LocalProvider } = createSimpleContext({
           }
         }
 
+        // Prefer altimate-backend when configured
+        const altimateProvider = sync.data.provider.find((x) => x.id === "altimate-backend")
+        if (altimateProvider?.models["altimate-default"]) {
+          return {
+            providerID: "altimate-backend",
+            modelID: "altimate-default",
+          }
+        }
+
         for (const item of modelStore.recent) {
           if (isModelValid(item)) {
             return item
diff --git a/packages/opencode/src/provider/provider.ts b/packages/opencode/src/provider/provider.ts
@@ -18,6 +18,7 @@ import { iife } from "@/util/iife"
 import { Global } from "../global"
 import path from "path"
 import { Filesystem } from "../util/filesystem"
+import { AltimateApi } from "../altimate/api/client"
 
 // Direct imports for bundled providers
 import { createAmazonBedrock, type AmazonBedrockProviderSettings } from "@ai-sdk/amazon-bedrock"
@@ -178,6 +179,26 @@ export namespace Provider {
         options: hasKey ? {} : { apiKey: "public" },
       }
     },
+    "altimate-backend": async () => {
+      const isConfigured = await AltimateApi.isConfigured()
+      if (!isConfigured) return { autoload: false }
+
+      try {
+        const creds = await AltimateApi.getCredentials()
+        return {
+          autoload: true,
+          options: {
+            baseURL: `${creds.altimateUrl.replace(/\/+$/, "")}/agents/v1`,
+            apiKey: creds.altimateApiKey,
+            headers: {
+              "x-tenant": creds.altimateInstanceName,
+            },
+          },
+        }
+      } catch {
+        return { autoload: false }
+      }
+    },
     openai: async () => {
       return {
         autoload: false,
@@ -877,6 +898,43 @@ export namespace Provider {
       }
     }
 
+    // Register altimate-backend as an OpenAI-compatible provider
+    if (!database["altimate-backend"]) {
+      const backendModels: Record<string, Model> = {
+        "altimate-default": {
+          id: ModelID.make("altimate-default"),
+          providerID: ProviderID.make("altimate-backend"),
+          name: "Altimate AI",
+          family: "openai",
+          api: { id: "altimate-default", url: "", npm: "@ai-sdk/openai-compatible" },
+          status: "active",
+          headers: {},
+          options: {},
+          cost: { input: 0, output: 0, cache: { read: 0, write: 0 } },
+          limit: { context: 200000, output: 128000 },
+          capabilities: {
+            temperature: true,
+            reasoning: false,
+            attachment: false,
+            toolcall: true,
+            input: { text: true, audio: false, image: true, video: false, pdf: false },
+            output: { text: true, audio: false, image: false, video: false, pdf: false },
+            interleaved: false,
+          },
+          release_date: "2025-01-01",
+          variants: {},
+        },
+      }
+      database["altimate-backend"] = {
+        id: ProviderID.make("altimate-backend"),
+        name: "Altimate",
+        source: "custom",
+        env: [],
+        options: {},
+        models: backendModels,
+      }
+    }
+
     function mergeProvider(providerID: ProviderID, provider: Partial<Info>) {
       const existing = providers[providerID]
       if (existing) {
diff --git a/packages/opencode/src/util/filesystem.ts b/packages/opencode/src/util/filesystem.ts
@@ -55,6 +55,7 @@ export namespace Filesystem {
     try {
       if (mode) {
         await writeFile(p, content, { mode })
+        await chmod(p, mode)
       } else {
         await writeFile(p, content)
       }
@@ -63,6 +64,7 @@ export namespace Filesystem {
         await mkdir(dirname(p), { recursive: true })
         if (mode) {
           await writeFile(p, content, { mode })
+          await chmod(p, mode)
         } else {
           await writeFile(p, content)
         }
