.codex-plugin/plugin.json

{
  "name": "app-6a8df1b568f08191af42b4e26e012044",
  "version": "1.2.0",
  "description": "Connect AI agents to Heptabase to search, read, create, and update knowledge through the hosted MCP server.",
  "author": {
    "name": "Hepta Platforms, Inc.",
    "url": "https://heptabase.com"
  },
  "homepage": "https://support.heptabase.com",
  "repository": "https://github.com/heptameta/heptabase-agent-plugins",
  "license": "MIT",
  "keywords": [
    "heptabase",
    "knowledge management",
    "notes",
    "whiteboards",
    "mcp"
  ],
  "interface": {
    "displayName": "Heptabase",
    "shortDescription": "Search and update your notes",
    "longDescription": "Connect ChatGPT and Codex to your Heptabase knowledge base. Search and read cards, journals, PDFs, tags, databases, and whiteboards; view selected cards in an interactive reader; create and edit notes; update properties; and place existing objects on whiteboards.\n\nThe plugin also includes Heptabase Explainer Studio, a skill that turns teaching material, such as lecture notes, a paper, or a codebase, into narrated, animated explainer videos. The videos are made on your computer, so Explainer Studio works in Codex and in local threads of the ChatGPT desktop app, not in ChatGPT on the web or on mobile. The first time, it asks before installing its tools (about 1.5 GB). It needs no Heptabase account.",
    "developerName": "Hepta Platforms, Inc.",
    "category": "Productivity",
    "capabilities": [
      "Read",
      "Write",
      "Interactive"
    ],
    "websiteURL": "https://heptabase.com",
    "supportURL": "https://support.heptabase.com",
    "privacyPolicyURL": "https://heptabase.com/privacy_policy",
    "termsOfServiceURL": "https://heptabase.com/terms_of_service",
    "defaultPrompt": [
      "Find my recent notes about a topic and summarize the key ideas.",
      "Create a card in Heptabase from this conversation.",
      "Update a card's status property in Heptabase."
    ],
    "composerIcon": "./assets/heptabase.png",
    "logo": "./assets/heptabase.png",
    "screenshots": []
  },
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "release_notes": "Version 1.2.0 adds the Heptabase Explainer Studio skill, which turns teaching material into narrated, animated explainer videos on the user's computer. The listing text now describes it and where it works. The Heptabase MCP server is unchanged.\n\nAbout the explainer-studio skill findings (persistence and remote code execution): the skill installs Heptabase Explainer Studio, our open-source command-line tool (MIT, https://github.com/heptameta/heptabase-explainer-studio), on the user's computer. It asks the user before it installs anything, and it installs into the user's home folder without an administrator password:\n- uv, the Python tool manager from astral.sh, if it is missing;\n- the latest tagged release of Explainer Studio from GitHub, installed with uv;\n- ffmpeg, TinyTeX, fonts, and map data, installed by `explainer-studio setup`.\n\nTo make the command available in new terminals, it runs uv's standard `uv tool update-shell`, which adds uv's tool folder to PATH. Setting `UV_NO_MODIFY_PATH=1` skips this. In a cloud container or without a local shell, such as ChatGPT on the web or on mobile, the skill installs and runs nothing and tells the user to use Codex on their computer."
      }
    }
  },
  "apps": "./.app.json"
}