Skip to main content

Install

Binary​

Download from GitHub Releases​

Download agentsmithy-<os>-<arch> from the latest release.

go install​

go install github.com/iorubs/agentsmithy/cmd/agentsmithy@latest

Connect your agent​

Optionally, move the binary to a directory in your PATH.

VS Code; add to .vscode/mcp.json:

{
  "servers": {
    "agentsmithy": {
      "command": "agentsmithy",
      "args": ["serve", "--transport", "mcp-stdio"]
    }
  }
}

Docker​

Connect your agent​

VS Code; add to .vscode/mcp.json:

{
  "servers": {
    "agentsmithy": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "${workspaceFolder}:/project:ro",
        "-w", "/project",
        "smithylabs/agentsmithy:latest",
        "serve", "--transport", "mcp-stdio"
      ]
    }
  }
}

Next steps​

Next you'll need a .agentsmithy.yaml config. See the Use Cases section to find a scenario that fits your needs, then follow the tip at the bottom to generate your config with your agent.