# dwaar

> Dwaar Console finds what you ship, shows what is wrong with it, and which problems an attacker can reach. Its MCP server gives a coding agent the person's findings, resources and scans, signed in as that person.

I want you to install Dwaar for me. Execute all the steps below autonomously, and stop only where a step says to ask me.

OBJECTIVE: Install the Dwaar plugin (skills and the MCP server `https://console.stg.dwaar.ai/mcp`) in the coding agent you are running in, and sign me in.

DONE WHEN: the Dwaar `session` tool answers with my name.

## TODO

- [ ] Detect which coding agent you are
- [ ] Ask me to approve the install command, then run it
- [ ] Sign in to the dwaar MCP server (I finish this in the browser)
- [ ] Call the `session` tool and greet me by name
- [ ] If my tenant is empty, send me to connect source control in the browser

## Shared or dedicated address

The addresses below are the shared ones, and the default: MCP server `https://console.stg.dwaar.ai/mcp`, console `https://console.stg.dwaar.ai`. A customer with a dedicated Dwaar tenant has its own console and MCP addresses, and the MCP server and the console can be on different domains. Use a dedicated address only if I say I have a dedicated tenant and give you its MCP address; never guess one, and do not ask me whether I have one. With a dedicated address, run `npx skills add DwaarAI/dwaar-agent` and the MCP only command for your agent with my address in place of the shared one: the plugin carries the shared address.

## Step 1: Detect which coding agent you are

You must know which agent you are before you run anything. Use what you know about yourself first. If you are unsure, check which of these commands exists: `claude`, `codex`, `agy`, `gemini`, `opencode`, `code`. If none fits, you are an "other agent" in Step 2.

## Step 2: Install

You need my approval: show me the command for your agent and run it only after I say yes. Use the plugin. Use the MCP only command only if the plugin command fails.

Claude Code:

```bash
claude plugin marketplace add DwaarAI/dwaar-agent
claude plugin install dwaar@dwaar
# MCP only:
claude mcp add --transport http dwaar https://console.stg.dwaar.ai/mcp
```

Codex (CLI or IDE):

```bash
codex plugin marketplace add DwaarAI/dwaar-agent
codex plugin add dwaar@dwaar
# MCP only:
codex mcp add dwaar --url https://console.stg.dwaar.ai/mcp
```

Cursor: plugins come from a team marketplace, so tell me a team admin can import `https://github.com/DwaarAI/dwaar-agent` (Dashboard > Plugins & MCPs > Add Marketplace > Import from Repo), after which I install dwaar from Customize. Without that, run `npx skills add DwaarAI/dwaar-agent` for the skills, and for the MCP server add this to `~/.cursor/mcp.json`:

```json
{ "mcpServers": { "dwaar": { "url": "https://console.stg.dwaar.ai/mcp" } } }
```

VS Code with Copilot: tell me to enable the `chat.plugins.enabled` setting, then run Chat: Install Plugin from Source from the Command Palette and enter `https://github.com/DwaarAI/dwaar-agent`. MCP only:

```bash
code --add-mcp '{"name":"dwaar","type":"http","url":"https://console.stg.dwaar.ai/mcp"}'
```

Antigravity:

```bash
agy plugin install https://github.com/DwaarAI/dwaar-agent
```

Antigravity MCP only: add this to `~/.gemini/config/mcp_config.json`:

```json
{ "mcpServers": { "dwaar": { "serverUrl": "https://console.stg.dwaar.ai/mcp" } } }
```

Gemini CLI (paid and enterprise accounts only; individual accounts moved to Antigravity on 2026-06-18, so use Antigravity unless my organization still runs Gemini CLI):

```bash
gemini extensions install https://github.com/DwaarAI/dwaar-agent
# MCP only:
gemini mcp add --transport http -s user dwaar https://console.stg.dwaar.ai/mcp
```

OpenCode:

```bash
npx skills add DwaarAI/dwaar-agent
opencode mcp add dwaar --url https://console.stg.dwaar.ai/mcp
```

Other agents (Windsurf, Devin, Zed, Cline, ...): run `npx skills add DwaarAI/dwaar-agent`, then add `https://console.stg.dwaar.ai/mcp` as a remote MCP server (Streamable HTTP, OAuth) in your MCP configuration.

Some agents load a new plugin or MCP server only after a restart. If yours does, tell me to restart you and paste `Connect me to Dwaar (docs.dwaar.ai)` again, then continue from Step 3.

## Step 3: Sign in

Start the sign-in for your agent:

- Claude Code after the plugin install: `claude mcp login plugin:dwaar:dwaar`, or tell me to run `/mcp`, choose plugin:dwaar:dwaar, then Authenticate
- Claude Code after the MCP only install: `claude mcp login dwaar`, or tell me to run `/mcp`, choose dwaar, then Authenticate
- Codex: `codex mcp login dwaar`
- Cursor: tell me to choose Connect next to dwaar in the MCP settings
- VS Code: the sign-in starts when you first call a dwaar tool
- Antigravity: the sign-in starts when you first connect to the dwaar server
- Gemini CLI: tell me to run `/mcp auth dwaar`
- OpenCode: `opencode mcp auth dwaar`

Over SSH without a browser on this machine, add `--no-browser` to the Claude Code or Codex login, for example `claude mcp login plugin:dwaar:dwaar --no-browser`, and tell me to open the URL it prints.

My browser opens. Tell me what to expect there, in this order:

1. Sign in or sign up with my work email. Personal addresses are refused.
2. The first time only: Create your organization. If it says Ask for an invite instead, my company already uses Dwaar and an administrator has to invite me first.
3. The consent page: choose Read only or Read and write, then Approve.

Never ask me for a password, a token or an API key in chat. If I run you headless (CI, `claude -p`) and cannot open a browser, I create an API key in the console under Settings > API and you send it as `Authorization: Bearer dwc_...`. For Claude Code: `claude mcp add --transport http dwaar https://console.stg.dwaar.ai/mcp --header "Authorization: Bearer dwc_..."`.

## Step 4: Confirm

You must call the dwaar `session` tool. It returns my name and my tenant. Greet me by name.

## Step 5: First value

If `session` says my tenant is empty, do not try to connect anything yourself: a connection stores a credential, and credentials never pass through chat. Send me to `https://console.stg.dwaar.ai/integrations/github` (or the provider I use, from the `providers` tool; on a dedicated tenant, the console the dwaar server's instructions name) and ask me to choose Add connection. Then follow `discoveryJobs` and `scans` until findings appear.

If my tenant has data, use `search` or `resources` to find the resource for the repository we are in (match its git remote), then read its worst open `findings`.

EXECUTE NOW: Complete the above TODO list to achieve: the Dwaar `session` tool answers with my name.

For everything else, including what each tool does and troubleshooting, read [llms.txt](https://docs.dwaar.ai/llms.txt) and [Connect a coding agent](https://docs.dwaar.ai/console/getting-started/coding-agents).
