Agent integrations

Air Context integrates into your AI coding agents through components that the jbcontext setup-agent command installs: usage instructions, skills, a subagent, hooks, an MCP server, and, for OpenAI Codex, execution-policy rules. The integrations are open source and published in the JetBrains/context repository on GitHub.

For the command and its options, see jbcontext setup-agent.

Supported agents

jbcontext setup-agent sets up the following agents:

Claude Code
OpenAI Codex
Junie CLI
Any other agent, with --agent generic: the command installs the usage instructions and the context-search skill into the current project.

Air Teams comes with built-in Air Context support, and Air in IDEs uses the CLI installation. Both are described in Where you can use Air Context.

Installed components

By default, jbcontext setup-agent installs the recommended bundle of components for the agent you choose. The following table shows what each agent gets by default. To install only specific components, pass the corresponding options of setup-agent, listed in the last column.

Component	What it does	Installed by default for	Option
Instructions	Air Context usage instructions added to the agent's instructions file.	All agents	`--instructions`
Skills	Task-oriented instructions that teach the agent when and how to query Air Context instead of manual exploration, such as `context-search` for a semantic search. See Skills.	All agents except OpenAI Codex	`--skills`
Subagent	The `context-explorer` subagent: a read-only exploration agent that runs multiple semantic searches in an isolated context and returns file and line references with snippets.	Claude Code, OpenAI Codex, and Junie CLI	`--subagents`
Session hooks	Hooks that incrementally refresh an existing index when an agent session starts or ends.	Claude Code, OpenAI Codex, and Junie CLI	Included with the default set; `--no-session-hooks` skips them
Tool-watching hooks	Optional tool-watching reminder hooks.	Not installed by default	`--hooks`
MCP server	The Air Context MCP server with tools for searching the index, registered in the agent's MCP configuration.	Claude Code	`--mcp-minimal` registers the server; `--mcp` also switches the instructions to prefer MCP tools
Execution-policy rules	Rules that let OpenAI Codex run the read-only Air Context query commands without asking you for approval each time.	OpenAI Codex	`--rules`

Setup options

Besides selecting components, jbcontext setup-agent has options that change how the components are installed:

--strong installs instructions that strongly prioritize semantic search over grep-style text search.
--scope project installs the components for the current project only instead of for the current user.

Skills

jbcontext setup-agent installs the context-search skill, which runs a semantic search over the codebase.

The JetBrains/context repository also contains skills that setup-agent doesn't install. You can add them to your agent manually:

context-research: Deep exploration of a codebase using Air Context searches. See context-research on GitHub.
context-review: Reviews code changes, using semantic search to understand their context and impact. See context-review on GitHub.
context-install: Installs the Air Context CLI. See context-install on GitHub.

Update or remove integrations

jbcontext upgrade updates the CLI and refreshes the installed agents' skills, hooks, and instructions to match the new version. To uninstall the integration components from an agent, run jbcontext remove-agent.

05 November 2026