TimeBase Agent Plugins

TimeBase plugins for Cursor, VSCode, Claude Code, and any tool supporting the Open Plugin standard.

If you only need skills, jump to Skills.

Quickstart

1. Install uv

Install uv if uvx is not available.

Check that uvx is available in your shell:

uvx -V

2. Install plugin in your tool

Cursor

Clone this repository as a local plugin.

macOS/Linux:

git clone https://github.com/epam/TimeBase-Agent-Plugins.git ~/.cursor/plugins/local/timebase

Windows:

git clone https://github.com/epam/TimeBase-Agent-Plugins.git %USERPROFILE%\.cursor\plugins\local\timebase

Open Cursor Settings > Plugins > TimeBase Plugin > TimeBase MCP to edit configuration.
Available options: MCP configuration.

VSCode

Open command palette (CMD+Shift+P / Ctrl+Shift+P), run Chat: Install Plugin from Source, then paste:

https://github.com/epam/TimeBase-Agent-Plugins.git

In chat panel, click Configure Tools, hover timebase-mcp, then click Configure TimeBase. Available options: MCP configuration.

Claude Code

Open Claude Code and run the following commands:

/plugin marketplace add https://github.com/epam/TimeBase-Agent-Plugins.git
/plugin install timebase@timebase-plugins
/reload-plugins

You will be prompted to configure MCP during installation.
Available options: MCP configuration.

[!WARNING] On macOS there's an upstream issue with plugin configuration sometimes not being passed to the MCP. As a workaround, you can disable the plugin-managed MCP server from the /plugin menu and manually add it using the following command:

claude mcp add timebase-mcp --transport stdio --env TIMEBASE_URL='dxtick://localhost:8011' -- uvx --from 'timebase-mcp[all]==0.2.0' timebase-mcp

Claude Desktop

Open Settings > Plugins > Add > Add Marketplace and paste:

epam/TimeBase-Agent-Plugins

Press Sync button and wait for the plugin list to appear.

Select TimeBase and click the + to install.

Other tools

This repository follows the Open Plugin standard, so it can be used in any compatible tool.

Note

If you encounter issues with the MCP server, check out the troubleshooting guide.

Updating an existing plugin installation

Updating the plugin updates the pinned TimeBase MCP version. You do not need to update TimeBase MCP separately.

Cursor

If you cloned the plugin locally, pull the latest changes:

macOS/Linux:

git -C ~/.cursor/plugins/local/timebase pull

Windows:

git -C %USERPROFILE%\.cursor\plugins\local\timebase pull

VSCode

VS 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.

Claude Code

Inside Claude Code session run:

/plugin

Navigate to the installed plugin and click Update button.

Other tools

Refer to your tool's documentation for updating plugins installed from a repository source.

Skills

Warning

The qql-generator skill is built around grounding from TimeBase MCP. For task-correct, schema-backed QQL, run the agent with TimeBase MCP configured. Usage without MCP is not recommended, you are likely to get materially worse results.

Prerequisites

• Node.js installed (for npx).

Installation

npx skills (recommended)

Works for Claude Code, Cursor, VSCode and any other tool supporting the Agent Skills open standard.

npx skills add https://github.com/epam/TimeBase-Agent-Plugins.git

Manual installation

1. Clone this repository:

git clone https://github.com/epam/TimeBase-Agent-Plugins.git

2. Copy the desired /skills/<skill-name> directory into your tool's skills installation folder.

Usage

No special actions are required. Just ask your agent something about QQL.

Updating

To update skills you already installed from this repository:

npx skills update

To install a newly added skill from this repository, run the installation command again or copy the new skill directory manually.

Uninstallation

npx skills remove