# Agentic Dev Tools — Install Guide

Agentic Dev Tools connects your AI coding assistant to a curated library of 100+
engineering standards over an MCP (Model Context Protocol) server. The installer
downloads a local `server.py`, verifies its checksum, and registers it with your
assistant.

> This is the machine-readable mirror of https://j2clark.info/agentic (a
> JavaScript single-page app that does not render for non-browser agents). If a
> command here disagrees with that page, the page is authoritative.

**Prerequisites (all assistants):** Python 3.8+ (`python3 --version` on
macOS/Linux, `python --version` on Windows).

---

## Claude Code

Claude Code is a CLI tool; install the MCP server with a single command.
Also requires the Claude Code CLI: https://code.claude.com/docs/en/setup

**macOS / Linux**

```bash
curl -sSL https://agentic.j2clark.info/install.sh | bash
```

**Windows (PowerShell)**

```powershell
irm https://agentic.j2clark.info/install.ps1 | iex
```

If Windows Defender blocks the piped script, download and run it separately:

```powershell
irm https://agentic.j2clark.info/install.ps1 -OutFile install.ps1
.\install.ps1
Remove-Item install.ps1
```

**Verify**

```bash
claude mcp list
```

Expected output:

```
agentic-standards: python ~/.local/bin/agentic-standards-mcp.py - ✓ Connected
```

**Uninstall (macOS / Linux)**

```bash
claude mcp remove agentic-standards
rm -f ~/.local/bin/agentic-standards-mcp.py
rm -rf ~/.local/bin/agentic-hooks/
rm -rf ~/.claude/agentic-state/
# Then remove any "agentic-hooks" entries from your Claude settings.json hooks.
```

**Uninstall (Windows)**

```powershell
claude mcp remove agentic-standards
Remove-Item $env:USERPROFILE\.local\bin\agentic-standards-mcp.py -ErrorAction SilentlyContinue
Remove-Item -Recurse $env:USERPROFILE\.local\bin\agentic-hooks\ -ErrorAction SilentlyContinue
Remove-Item -Recurse $env:USERPROFILE\.claude\agentic-state\ -ErrorAction SilentlyContinue
# Then remove any "agentic-hooks" entries from your Claude settings.json hooks.
```

---

## Cursor

Run the installer in your project directory. It writes `.cursor/mcp.json`,
`.cursor/rules/standards.mdc`, and `.agentic/server.py`.

**macOS / Linux**

```bash
curl -sSL https://agentic.j2clark.info/install.sh | bash -s -- --assistant cursor
```

**Windows (PowerShell)**

```powershell
& { $env:ASSISTANT='cursor'; irm https://agentic.j2clark.info/install.ps1 | iex }
```

Verify in Cursor Settings → MCP: `agentic-standards: Connected`.
Uninstall: remove `.cursor/mcp.json`, `.cursor/rules/standards.mdc`, and `.agentic/`.

---

## Amazon Q Developer

Run the installer in your project directory. It writes `.amazonq/default.json`,
`.amazonq/rules/standards.md`, and `.agentic/server.py`.

**macOS / Linux**

```bash
curl -sSL https://agentic.j2clark.info/install.sh | bash -s -- --assistant amazonq
```

**Windows (PowerShell)**

```powershell
& { $env:ASSISTANT='amazonq'; irm https://agentic.j2clark.info/install.ps1 | iex }
```

Verify in Amazon Q chat with `/mcp`: `agentic-standards: Connected`.
Uninstall: remove `.amazonq/default.json`, `.amazonq/rules/standards.md`, and `.agentic/`.

---

## GitHub Copilot

Run the installer in your project directory. It writes `.vscode/mcp.json`,
`.github/copilot-instructions.md`, and `.agentic/server.py`.

**macOS / Linux**

```bash
curl -sSL https://agentic.j2clark.info/install.sh | bash -s -- --assistant copilot
```

**Windows (PowerShell)**

```powershell
& { $env:ASSISTANT='copilot'; irm https://agentic.j2clark.info/install.ps1 | iex }
```

Verify in VS Code → Command Palette → "MCP: List Servers": `agentic-standards: Connected`.
Uninstall: remove `.vscode/mcp.json`, `.github/copilot-instructions.md`, and `.agentic/`.

---

## MCP tools you get (Claude Code)

- **Standards search:** `search_standards`, `list_standards`, `get_standard`
- **Project analysis:** `detect_technologies`, `read_current_claudemd`, `check_for_updates`
- **Skills:** `list_skills`, `generate_skill`, `apply_skill`
- **Configuration:** `get_questions`, `generate_claudemd`, `write_claudemd`

## No-install HTTP access

The standards are also queryable directly (`GET` for search, not `POST`):

```bash
curl -s "https://agentic.j2clark.info/search?q=lambda+testing&synthesize=false"
curl -s "https://agentic.j2clark.info/standards"
curl -s "https://agentic.j2clark.info/standards/lambda-no-fire-and-forget"
```