opencode-createos

OpenCode plugin for the CreateOS deployment platform.

Deploy apps, manage environments, and configure domains — all from within opencode conversations.

Installation

# Install via npm / bun
bun install -g opencode-createos

Then add to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-createos"]
}

Set your CreateOS API key:

export CREATEOS_API_KEY=your_key_here

Get an API key at https://createos.nodeops.network/profile

Usage

Once installed, the agent can use these tools:

Deploy a project

createos_deploy({
  repoUrl: "https://github.com/user/my-app",
  projectName: "my-app",
  framework: "nextjs"
})

List projects

createos_list_projects({})

Check project status

createos_get_project({
  projectId: "proj_abc123"
})

Set environment variables

createos_set_env({
  projectId: "proj_abc123",
  envVars: {
    DATABASE_URL: "postgresql://...",
    NODE_ENV: "production"
  }
})

Add a custom domain

createos_add_domain({
  projectId: "proj_abc123",
  domain: "example.com"
})

SKILL.md (Optional)

For better agent discoverability, copy the skill to your opencode config:

cp -r skills/createos ~/.config/opencode/skills/createos/

Or to a project:

cp -r skills/createos .opencode/skills/createos/

MCP Fallback

For advanced CreateOS operations not covered by the plugin tools, add the CreateOS MCP server directly:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "createos": {
      "type": "remote",
      "url": "https://api-createos.nodeops.network/mcp",
      "headers": {
        "X-Api-Key": "{env:CREATEOS_API_KEY}"
      }
    }
  }
}

Development

git clone https://github.com/your-username/opencode-createos
cd opencode-createos
bun install
bun run build

License

MIT