# Connect JetBrains Junie

URL: https://getvando.com/docs/connect-an-ai/junie

Connect JetBrains Junie to the Vando app on your phone, so it gets a secret only after you tap Give, and keys stay out of your .env files and chats.

JetBrains’ coding agent: the Junie CLI, the IDE plugin and the AI Assistant chat. Last checked 2026-11-10, against JetBrains Junie’s own documentation (the links at the end). If a step doesn’t match what you see, [tell us](https://getvando.com/support). For Claude Code, [Connect an AI](https://getvando.com/docs/connect-an-ai) is the same road.

## The steps every tool shares

**1.** Install `vando` in your own terminal (not through your AI tool):

```bash
npm i -g @getvando/cli --registry=https://registry.npmjs.org --@getvando:registry=https://registry.npmjs.org
```

No npm on this computer? The one-line installer gets the same signed vando:

```bash
curl -fsSL https://getvando.com/install.sh | sh
```

**2.** Connect it to your phone. It shows a code that works once, for 10 minutes; open Vando on your phone, then **Connect an AI**, enter the code and tap **Connect**. Run `vando connect` again to finish. Do this in your own terminal: it writes the connection’s key on this computer, and many sandboxes block that.

```bash
vando connect
```

**3.** Save a secret once. Without a terminal it opens a one-time page in your own browser; you paste the value there and it goes to your phone, locked so only the phone can open it. Tap Save on the phone. Or add it in the Vando app.

```bash
vando add STRIPE_KEY
```

**4.** Your tool runs a command with it. Your phone shows what is asked and for how long; you give it or deny it there, and the value goes into that one program’s environment, as the variable `STRIPE_KEY`.

```bash
vando run --secret STRIPE_KEY -- node send.js
```

A `.env` line can name a secret instead of holding it, and `vando run` fills it in when the program starts:

```text
STRIPE_KEY=vando://Work/acme/dev/STRIPE_KEY
```

**5.** Tell your tool how to ask: put this note in its instructions file (the file is named below):

```md
## Secrets (Vando)
- Never open, print, copy or edit `.env*` files or secret values, and never put a secret in chat.
- Run anything that needs a secret as `vando run --secret NAME -- <command>` (repeat `--secret` for more than one).
- Exit 75 means it is waiting for the owner's phone: say "Approve NAME on your phone, then I'll run it again", do other work, then run the same command again. After two waits, stop and tell the owner to open Vando on their phone (the request is in the Inbox).
- Exit 77 means the owner said no or the access ended: don't retry; ask the owner.
- Output that shows `[vando:NAME]` had a secret hidden; that is expected.
- Don't use `vando get` or `vando env --reveal`: they print values where you can read them. `vando env` (names only) is fine.
- Never enter a connect code yourself.
```

## What differs for JetBrains Junie

### The instructions file

Put the note from step 5 in `AGENTS.md` in the project root. If the repository has `.junie/AGENTS.md`, Junie uses that file on its own and ignores the root one, so put the note in whichever file wins (`~/.junie/AGENTS.md` covers every project).

**Every project:** `~/.junie/AGENTS.md` is included whenever it exists; project guidelines win where they conflict. The note to put there: [Use Vando in every project](https://getvando.com/docs/connect-an-ai/every-project).

### Approvals and the sandbox

Junie’s CLI asks before most terminal commands. To skip its prompt for `vando run` (your phone still asks), add an entry to `~/.junie/allowlist.json`:

```json
{ "defaultBehavior": "ask", "rules": { "executables": { "rules": [ { "prefix": "vando run ", "action": "allow" } ] } } }
```

Each part of a chained command must match, and multi-line commands always ask. In the IDE plugin the Action Allowlist takes terminal rules as Java regular expressions, for example `^\Qvando run --secret \E[^\s;&|<>@$]+ -- .*$`. Junie’s sandbox (`junie --sandbox`, in its preview builds) leaves the network open but limits writes to the project, so `vando connect` will probably fail inside it: run it in your own terminal.

### MCP tools (optional)

Most work goes through `vando run`, which keeps secrets out of the chat. Add the tools only when JetBrains Junie must read a value itself; a value a tool returns stays in the conversation ([the tools](https://getvando.com/docs/reference/mcp)). Add the server to `.junie/mcp/mcp.json` (this project) or `~/.junie/mcp/mcp.json`; the IDE’s Tools, Junie, MCP Settings page saves to the user file:

```json
{ "mcpServers": { "vando": { "command": "vando", "args": ["mcp"], "timeout": 120000 } } }
```

The default request timeout is one minute and covers tool calls; `timeout` is in milliseconds. In the CLI, `/mcp` lists the server. The IDE’s MCP allow rule covers all MCP tools; there are no per-server rules yet.

### Cloud and remote sessions

Junie’s remote mode tunnels a session that is running on your computer, so commands still run there and Vando works as it does locally (the computer must stay awake). Junie’s GitHub Action runs unattended on a runner; use Vando with Junie on a computer you sit at.

### If something goes wrong

- A `.junie/AGENTS.md` in the repository hides the root `AGENTS.md` and the note in it.
- The one-minute MCP timeout is tight against a phone approval; set `timeout` to 120000.
- Restart the IDE after installing `vando`, so its terminal has the new `PATH`.
- How long the CLI lets a command run isn’t documented.
- Run `vando doctor` in your own terminal: it says what is wrong and the command that fixes it.
- If a `vando` command stops, relay what it says; the line ends with a link to [the errors reference](https://getvando.com/docs/reference/errors).

## Sources

What this page is written from:

- [Junie: guidelines and memory](https://junie.jetbrains.com/docs/guidelines-and-memory.html)
- [Junie: MCP configuration](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html)
- [Junie: CLI allowlist](https://junie.jetbrains.com/docs/action-allowlist-junie-cli.html)
- [Junie: IDE allowlist](https://junie.jetbrains.com/docs/action-allowlist.html)
- [Junie: remote mode](https://junie.jetbrains.com/docs/junie-cli-remote-mode.html)
