Vibecape

CUSTOM MODELS & EXTENSIONS

Connect your own models.
Build custom extensions.

Connect Codex, Claude Code, or private team models through Downcity Federation. Use Extension Kit to add document menus, main views, and settings.Explore both options

01 · CUSTOM MODELS

Connect your own models to Vibecape

Register models in a Federation Server and start it, then enter its URL and sign in from Vibecape Account settings.Read the custom model guide
server.ts
Register models
const models = [
  provider.model({
    id: "team-codex",
    name: "Team Codex",
    meta: {
      upstream_model: "gpt-5-codex",
    },
  }),
];

const federation = new Federation({ db });
federation.use(
  new AIService().use(models),
);
A public model ID maps to the real upstream model
02
Start the server

Starting the server gives you a Federation URL.

pnpm start --codex
http://127.0.0.1:3000

02 · CUSTOM EXTENSIONS

One extension, built from three parts

The manifest declares the extension, Main handles privileged logic, and Renderer contributes UI and entry points to Vibecape.Read the extension guide
Vibecape Extension
com.example.my-extension
01 · DECLAREmanifest.json

Defines extension identity and code entry points.

id
com.example.my-extension
main
dist/main/index.js
renderer
dist/renderer/index.js
02 · LOGICmain/index.ts

Registers actions and uses host capabilities through App Bridge.

  • extension.action()Actions
  • app.filesRead and write files
  • app.systemSystem capabilities
03 · UIrenderer/index.tsx

Declares where the extension appears inside Vibecape.

Main ViewDocument MenuDialogSettings
@vibecape/extension-kitBuilds into an installable Vibecape extension