{
  "markdown": "# TimeBase Agent Plugins\n\nTimeBase plugins for Cursor, VSCode, Claude Code, OpenAI Codex, Gemini CLI, Antigravity CLI, and any tool supporting the Open Plugin standard.\n\nIf you only need skills, jump to [Skills](#skills).\n\n## Quickstart\n\n### 1. Install uv\n\nInstall [uv](https://docs.astral.sh/uv/getting-started/installation/) if `uvx` is not available.\n\nCheck that `uvx` is available in your shell:\n\n```bash\nuvx -V\n```\n\n### 2. Install plugin in your tool\n\n<details>\n<summary>Cursor</summary>\n\nClone this repository as a local plugin.\n\nmacOS/Linux:\n\n```bash\ngit clone https://github.com/epam/TimeBase-Agent-Plugins.git ~/.cursor/plugins/local/timebase\n```\n\nWindows:\n\n```bash\ngit clone https://github.com/epam/TimeBase-Agent-Plugins.git %USERPROFILE%\\.cursor\\plugins\\local\\timebase\n```\n\nOpen `Cursor Settings > Plugins > TimeBase Plugin > TimeBase MCP` to edit configuration.  \nAvailable options: [MCP configuration](https://github.com/epam/TimeBase-MCP/blob/main/docs/reference/environment-variables.md).\n\n</details>\n\n<details>\n<summary>VSCode</summary>\n\nSearch for `@agentPlugins timebase` in the Extensions tab to install.\n\nFor adjusting the settings open the chat panel, click `Configure Tools`, hover over `timebase-mcp`, then click `Configure TimeBase`.\nAvailable options: [MCP configuration](https://github.com/epam/TimeBase-MCP/blob/main/docs/reference/environment-variables.md).\n\n</details>\n\n<details>\n<summary>Claude Code</summary>\n\nOpen a terminal and run:\n\n```bash\nclaude plugin marketplace add epam/TimeBase-Agent-Plugins\nclaude plugin install timebase@timebase-plugins\n```\n\nYou will be able to configure MCP by running `/plugins` inside a Claude Code session, selecting the plugin under `Installed` and clicking `Configure options`.  \nAvailable options: [MCP configuration](https://github.com/epam/TimeBase-MCP/blob/main/docs/reference/environment-variables.md).\n\n> [!WARNING]\n> On macOS there's an [upstream issue](https://github.com/anthropics/claude-code/issues/11927) with plugin configuration sometimes not being passed to the MCP. \n> As a workaround, you can disable the plugin-managed MCP server from the `/plugin` menu and manually add it using the following command:\n> \n> ```bash\n> claude mcp add timebase --transport stdio --env TIMEBASE_URL='dxtick://localhost:8011' -- uvx --from 'timebase-mcp[all]==0.2.3' timebase-mcp\n> ```\n\n</details>\n\n<details>\n<summary>Claude Desktop</summary>\n\nOpen `Settings > Plugins > Add > Add Marketplace` and paste:\n\n```\nepam/TimeBase-Agent-Plugins\n```\n\nPress `Sync` button and wait for the plugin list to appear.\n\nSelect `TimeBase` and click the `+` to install.\n\n</details>\n\n<details>\n<summary>OpenAI Codex</summary>\n\nFrom your terminal, run:\n\n```bash\ncodex plugin marketplace add epam/TimeBase-Agent-Plugins\ncodex plugin add timebase@timebase-plugins\n```\n\nThen start a new Codex instance so the plugin skills and MCP tools are loaded.\n\nThe MCP server settings can be configured globally in `~/.codex/config.toml` or per project in `.codex/config.toml`:\n\n```toml\n[plugins.\"timebase@timebase-plugins\".mcp_servers.timebase.env]\nTIMEBASE_URL = \"dxtick://localhost:8011\"\n```\n\nCheck out the available [MCP configuration options](https://github.com/epam/TimeBase-MCP/blob/main/docs/reference/environment-variables.md).\n\n</details>\n\n<details>\n<summary>GitHub Copilot CLI</summary>\n\nIn your terminal, run:\n\n```bash\ncopilot plugin install timebase@awesome-copilot\n```\n\nThen start a new Copilot CLI session so the plugin is loaded.\n\nAdjust the MCP server settings via `/mcp edit timebase-mcp` command. \nCheck out the available [MCP configuration options](https://github.com/epam/TimeBase-MCP/blob/main/docs/reference/environment-variables.md).\n\n</details>\n\n<details>\n<summary>GitHub Copilot App</summary>\n\nUse the following button:\n\n[![Install TimeBase plugin](https://img.shields.io/badge/Install-TimeBase_Plugin-blue?logo=github&style=flat-square)](ghapp://plugins/marketplace/add?source=epam%2FTimeBase-Agent-Plugins)\n\nOr go to `Settings > Plugins` and search for `timebase`.\n\n</details>\n\n<details>\n<summary>Gemini CLI</summary>\n\nFrom your terminal, run:\n\n```bash\ngemini extensions install https://github.com/epam/TimeBase-Agent-Plugins\n```\n\nThen restart any pre-existing Gemini CLI sessions so the extension is loaded.\n\nExtension exposes the main [TimeBase MCP environment variables](https://github.com/epam/TimeBase-MCP/blob/main/docs/reference/environment-variables.md) as install-time settings.\n\nTo configure extension settings later, run:\n\n```bash\ngemini extensions config timebase\n```\n\n</details>\n\n<details>\n<summary>Antigravity CLI</summary>\n\nFrom your terminal, run:\n\n```bash\nagy plugin install https://github.com/epam/TimeBase-Agent-Plugins\n```\n\nThen start a new Antigravity CLI session so the plugin is loaded.\n\nCheck out the available [TimeBase MCP environment variables](https://github.com/epam/TimeBase-MCP/blob/main/docs/reference/environment-variables.md) for the full list of supported options.\n\n</details>\n\n<details>\n<summary>Other tools</summary>\n\nThis repository follows the [Open Plugin](https://open-plugins.com/) standard, so it can be used in any compatible tool.\n\n</details>\n\n> [!NOTE]\n> If you encounter issues with the MCP server, check out the [troubleshooting guide](https://github.com/epam/TimeBase-MCP/blob/main/docs/troubleshooting.md).\n\n### Updating an existing plugin installation\n\nUpdating the plugin updates the pinned TimeBase MCP version. You do not need to update TimeBase MCP separately.\n\n<details>\n<summary>Cursor</summary>\n\nIf you cloned the plugin locally, pull the latest changes:\n\nmacOS/Linux:\n\n```bash\ngit -C ~/.cursor/plugins/local/timebase pull\n```\n\nWindows:\n\n```bash\ngit -C %USERPROFILE%\\.cursor\\plugins\\local\\timebase pull\n```\n\n</details>\n\n<details>\n<summary>VSCode</summary>\n\nVS Code updates plugins automatically every 24 hours by default. To trigger an update manually, open command palette (CMD+Shift+P / Ctrl+Shift+P) and run `Extensions: Check for Extension Updates`.\n\n</details>\n\n<details>\n<summary>Claude Code</summary>\n\nInside Claude Code session run:\n\n```bash\n/plugin\n```\n\nNavigate to the installed plugin and click `Update` button.\n\n</details>\n\n<details>\n<summary>Claude Desktop</summary>\n\nUse the `Settings > Plugins > TimeBase > Update` button.\n\n</details>\n\n<details>\n<summary>OpenAI Codex</summary>\n\nRefresh the marketplace snapshot and reinstall the plugin:\n\n```bash\ncodex plugin marketplace upgrade timebase-plugins\ncodex plugin add timebase@timebase-plugins\n```\n\nThen restart any running Codex instances.\n\n</details>\n\n<details>\n<summary>GitHub Copilot CLI</summary>\n\nIn your terminal, run:\n\n```bash\ncopilot plugin update timebase\n```\n\nThen restart any running Copilot CLI sessions.\n\n</details>\n\n<details>\n<summary>GitHub Copilot App</summary>\n\nGo to `Settings > Plugins`, find `timebase` and click `Update plugin` under the 3-dot menu.\n\n</details>\n\n<details>\n<summary>Gemini CLI</summary>\n\nIn your terminal, run:\n\n```bash\ngemini extensions update timebase\n```\n\nThen restart any running Gemini CLI sessions.\n\n</details>\n\n<details>\n<summary>Antigravity CLI</summary>\n\nAntigravity CLI doesn't have a built-in update command. To update the plugin, follow the installation instructions again.\n\n</details>\n\n<details>\n<summary>Other tools</summary>\n\nRefer to your tool's documentation for updating plugins installed from a repository source.\n\n</details>\n\n## Skills\n\n> [!WARNING]\n> The **qql-generator** skill is built around grounding from **TimeBase MCP**. For task-correct, schema-backed QQL, run the agent with [TimeBase MCP](https://github.com/epam/TimeBase-MCP) configured.\n> Usage **without** MCP is **not recommended**, you are likely to get materially worse results.\n\n### Prerequisites\n\n- **Node.js** installed (for `npx`).\n\n### Installation\n\n#### npx skills (recommended)\n\nWorks for Claude Code, Cursor, VSCode and any other tool supporting the [Agent Skills](https://agentskills.io/home) open standard.\n\n```bash\nnpx skills add https://github.com/epam/TimeBase-Agent-Plugins.git\n```\n\n#### Manual installation\n\n1. Clone this repository:\n\n```bash\ngit clone https://github.com/epam/TimeBase-Agent-Plugins.git\n```\n\n2. Copy the desired `/skills/<skill-name>` directory into your tool's skills installation folder.\n\n### Usage\n\nNo special actions are required. Just ask your agent something about QQL.\n\n### Updating\n\nTo update skills you already installed from this repository:\n\n```bash\nnpx skills update\n```\n\nTo install a newly added skill from this repository, run the installation command again or copy the new skill directory manually.\n\n### Uninstallation\n\n```bash\nnpx skills remove\n```\n",
  "bytes": 8600,
  "sha": "4046297fbc20b7f5c64919efd29171fdb16f5002dd5b059cbc811ae635552481",
  "repo_slug": "epam/timebase-agent-plugins",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_epam_timebase_agent_plugins_1e1cfc71/readme"
}