# context-research

Finds code by meaning in an unfamiliar codebase, locating features, implementations and usage patterns before you change anything.

Skill by JetBrains. Category: Knowledge.

## Install

Project (for this project only):

```sh
npx skills add jetbrains/context --skill context-research
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add jetbrains/context --skill context-research -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Warn
- Snyk: Pass

Installs: 14. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/jetbrains/context/context-research)

## Source

[Open the source](https://github.com/jetbrains/context/tree/HEAD/skills/context-research). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: context-research
context: fork
agent: Explore
argument-hint: query
description: "Research and understand unfamiliar codebases using semantic search with `jbcontext search`"
---

You need to gather all context for task $ARGUMENTS thoroughly.

## When to Use

- Understanding unfamiliar codebases or locating specific functionality
- Finding implementations, definitions, or usage patterns
- Identifying code related to specific features or concepts
- Before making changes to understand the context and impact

## Tools Available

### `jbcontext search`

Semantic code search that finds code by meaning, not just exact keywords.

```bash
jbcontext search "<descriptive query>" [path]
jbcontext search -p <path> "<query>"  # <path> must be relative to the project root
```

**Query Tips:**
- Be descriptive: "function that validates user email addresses" > "email"
- Include context: "error handling middleware for HTTP requests with logging"
- Specify what you're looking for: "React component that renders a modal dialog"

## Research Workflow

1. **Start broad**: Use `jbcontext search` with general terms to understand the landscape
2. **Narrow down**: Add path filters (`-p`) once you identify relevant directories
3. **Read the code**: Once you find relevant files, read them to understand the details

## Example Session

```bash
# Find authentication-related code
jbcontext search "user authentication login"

# Narrow to specific directory
jbcontext search -p src/auth "JWT token validation"
```
````

- Previous: [context-search](https://syn4pse.dev/terminal/context-search.md)
- Next: [context-review](https://syn4pse.dev/terminal/context-review.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
