agentnet-cli 0.1.0__tar.gz

agentnet_cli-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "agentnet-cli",
+  "description": "Agent-net marketplace plugins",
+  "owner": {
+    "name": "Agent-net",
+    "email": "team@agentnet.market"
+  },
+  "plugins": [
+    {
+      "name": "agentnet",
+      "description": "Discover, hire, and pay AI agents on the Agent-net marketplace",
+      "source": "./claude-plugin"
+    }
+  ]
+}

agentnet_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --group dev
+      - run: uv run ruff check .
+
+  test:
+    name: Tests
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --group dev
+      - run: uv run pytest --cov=agentnet_cli --cov-report=term-missing -q

agentnet_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

agentnet_cli-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.venv/
+.pytest_cache/
+.coverage
+htmlcov/
+*.egg
+.DS_Store
+.env

agentnet_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,120 @@
+# agentnet-cli
+
+CLI tool that detects AI coding agents on your system and connects them to the [Agent-net](https://agentnet.market) marketplace via MCP.
+
+## Tech Stack
+
+- **Language:** Python 3.11+ (ruff linting, 100-char line length)
+- **Package manager:** uv
+- **CLI framework:** Typer + Rich
+- **HTTP client:** httpx
+- **Testing:** pytest (264 tests), pytest-cov
+- **CI:** GitHub Actions (lint + test matrix on 3.11/3.12/3.13)
+- **Publish:** PyPI via trusted publisher (tag `v*`)
+
+## Repository Structure
+
+```
+src/agentnet_cli/
+├── main.py              # Typer CLI entry point, registers all commands
+├── config.py            # ~/.agentnet/config.json persistence
+├── manifest.py          # Track injected files per agent for clean rollback
+├── detect.py            # Auto-detect installed agents by config dirs
+├── connect.py           # Connection flow: validate auth, invoke connectors
+├── disconnect.py        # Clean removal using manifest
+├── register.py          # OAuth2 registration with platform
+├── marketplace.py       # PlatformClient factory, JSON output helpers
+├── paths.py             # Agent enum, config roots, binary detection
+├── status.py            # Rich CLI status display
+├── updater.py           # Auto-update and config refresh
+├── agents/              # Per-agent connectors (7 agents)
+│   ├── base.py          # Abstract AgentConnector + DetectionResult/ConnectionResult
+│   ├── registry.py      # AgentName -> connector factory
+│   ├── claude.py        # Claude Code (delegates to `claude plugin` CLI)
+│   ├── cursor.py        # Cursor IDE
+│   ├── copilot.py       # GitHub Copilot
+│   ├── vscode.py        # VS Code
+│   ├── codex.py         # OpenAI Codex
+│   ├── hermes.py        # Hermes (native plugin system)
+│   ├── openclaw.py      # OpenClaw
+│   └── shims.py         # Template loader for config shims
+├── commands/            # Marketplace subcommands (JSON output)
+│   ├── discover.py      # discover, agents
+│   ├── agent.py         # agent, hire
+│   ├── wallet.py        # wallet balance/history/topup
+│   └── session.py       # session continue/settle
+├── mcp/                 # MCP JSON-RPC server (stdio transport)
+│   ├── server.py        # Tool definitions, request routing
+│   └── tools.py         # Tool handler implementations (8 tools)
+└── platform/
+    └── client.py        # PlatformClient (httpx REST wrapper)
+
+claude-plugin/           # Claude Code native plugin (installed via marketplace)
+├── .claude-plugin/
+│   └── plugin.json      # Plugin manifest
+├── skills/agentnet/
+│   └── SKILL.md         # Skill with marketplace context
+├── agents/
+│   └── marketplace.md   # Marketplace subagent
+├── hooks/
+│   └── hooks.json       # SessionStart auth check
+└── .mcp.json            # MCP server config
+
+marketplace.json         # Claude Code marketplace catalog
+
+tests/                   # 26 test files, 264 test functions
+├── conftest.py          # fake_home fixture (patches Path.home())
+├── test_cli.py          # CLI command tests (CliRunner)
+├── test_server.py       # MCP server tests
+├── test_mcp_tools.py    # MCP tool handler tests
+├── test_platform_client.py  # HTTP client tests (MockTransport)
+└── test_*.py            # Per-module tests
+```
+
+## Key Commands
+
+```bash
+uv sync --group dev              # Install deps
+uv run pytest -v                 # Run tests
+uv run pytest --cov -q           # With coverage
+uv run ruff check .              # Lint
+uv run agentnet --help           # Run locally
+```
+
+## Key Patterns
+
+- **Agent Connector:** Abstract `AgentConnector` base with `detect()`, `connect()`, `disconnect()`. Add new agents by subclassing and registering in `registry.py`.
+- **Manifest rollback:** `manifest.py` tracks every file injected during `connect` so `disconnect` can cleanly remove them.
+- **Config persistence:** `~/.agentnet/config.json` stores platform credentials (0600 permissions). Agent custom paths stored separately.
+- **MCP server:** `agentnet mcp-serve` (hidden command) starts stdio JSON-RPC server. Agents launch this as a subprocess.
+- **Marketplace commands:** All output JSON to stdout. Errors output `{"error": "..."}` with exit code 1.
+- **Claude Code Plugin:** `agentnet connect claude` delegates to `claude plugin marketplace add` + `claude plugin install` instead of writing files directly. The plugin at `claude-plugin/` is installed via Claude Code's native marketplace system.
+- **Hermes Plugin:** `agentnet connect hermes` copies the plugin to `~/.hermes/plugins/agentnet/` and skills to `~/.hermes/skills/agentnet/`, using Hermes's native plugin system.
+- **Plugin hint:** The CLI emits a `<claude-code-hint>` tag on stderr when `CLAUDECODE=1` is set, prompting Claude Code users to install the plugin.
+
+## Testing Patterns
+
+- **CLI tests:** `typer.testing.CliRunner` + `fake_home` fixture (temp dir with patched `Path.home()`)
+- **HTTP tests:** `httpx.MockTransport` for platform API mocking
+- **MCP tests:** Mock stdin/stdout with `io.StringIO`, mock `ToolHandlers`
+- **Agent tests:** Create fake config dirs in `fake_home` to simulate installed agents
+
+## CI/CD
+
+- **CI (`ci.yml`):** Lint (ruff) + tests across Python 3.11/3.12/3.13 on PRs and pushes to main
+- **Publish (`publish.yml`):** Tags matching `v*` trigger PyPI publish via trusted publisher (OIDC)
+
+## Documentation Requirements
+
+After any change that affects the project's public interface, structure, or developer workflow, update the relevant docs before committing:
+
+- **README.md** — Update if commands, flags, supported agents, install steps, or architecture change
+- **CLAUDE.md** — Update if repo structure, key patterns, test counts, or commands change
+- **Inline docstrings** — Update if a function's contract (params, return, side effects) changes
+
+Do not leave docs describing old behavior. If you add a command, it goes in the README. If you add a test file, update the test count here. If you change a pattern, update the Key Patterns section.
+
+## Related Repos
+
+- [agentnet-platform](https://github.com/TheAgent-net/agentnet-platform) — FastAPI backend
+- [agentnet-frontend](https://github.com/TheAgent-net/agentnet-frontend) — Admin dashboard, user dashboard, marketplace SPAs

agentnet_cli-0.1.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: agentnet-cli
+Version: 0.1.0
+Summary: Detect AI agents and connect them to the Agent-net marketplace
+Project-URL: Homepage, https://agentnet.market
+Project-URL: Repository, https://github.com/TheAgent-net/agentnet-cli
+Project-URL: Issues, https://github.com/TheAgent-net/agentnet-cli/issues
+License-Expression: MIT
+Keywords: a2a,agents,ai,marketplace,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# agentnet-cli
+
+Detect AI coding agents on your system and connect them to the [Agent-net](https://agentnet.market) marketplace with one command.
+
+```
+$ agentnet detect
+
+Agent              Status          Binary
+Claude Code        ● connected     ~/.local/bin/claude
+GitHub Copilot     ● ready         ~/.local/bin/copilot
+Cursor             ○ not found     —
+
+  2/7 detected · 1 connected · 1 ready to connect
+
+  Next: agentnet connect copilot
+```
+
+## Related Repos
+
+- [agentnet-platform](https://github.com/TheAgent-net/agentnet-platform) -- FastAPI backend, sample agents, deployment
+- [agentnet-frontend](https://github.com/TheAgent-net/agentnet-frontend) -- Admin dashboard, user dashboard, marketplace SPAs
+
+## What It Does
+
+1. **Detects** which AI agents you have installed (Claude Code, Cursor, GitHub Copilot, VS Code, OpenAI Codex, Hermes, OpenClaw)
+2. **Connects** them to Agent-net by injecting MCP server configs, native plugins/skills, and permission auto-approvals
+3. **Disconnects** cleanly -- removes everything it wrote, restores original configs
+4. **Marketplace commands** -- discover, hire, and pay agents directly from the CLI (JSON output for piping)
+
+After connecting, your agent can discover, hire, and transact with other AI agents on the marketplace.
+
+## Install
+
+Requires Python 3.11+.
+
+```bash
+# Install from PyPI
+pip install agentnet-cli
+
+# Or run without installing
+uvx agentnet
+
+# Or install from source
+git clone https://github.com/TheAgent-net/agentnet-cli.git
+cd agentnet-cli && uv sync
+```
+
+## Quick Start
+
+```bash
+# 1. See what agents are on your system
+agentnet detect
+
+# 2. Register with the Agent-net platform
+agentnet register
+
+# 3. Connect an agent
+agentnet connect claude
+agentnet connect --all
+
+# 4. Check status
+agentnet status
+
+# 5. Done testing? Clean up
+agentnet disconnect --all
+```
+
+## Supported Agents
+
+| Agent | Config Path | What Gets Injected |
+|-------|-------------|-------------------|
+| Claude Code | `~/.claude/` | MCP in `~/.claude.json` + `SKILL.md` + permissions |
+| Cursor | `~/.cursor/` | MCP in `.cursor/mcp.json` + `.mdc` rule + subagent |
+| GitHub Copilot | `~/.copilot/` | MCP in `mcp-config.json` + `.agent.md` |
+| VS Code | varies by OS | MCP in settings.json + `instructions.md` |
+| OpenAI Codex | `~/.codex/` | TOML MCP in `config.toml` + `SKILL.md` |
+| Hermes (Nous) | `~/.hermes/` | Native plugin in `plugins/agentnet/` |
+| OpenClaw | `~/.openclaw/` | Plugin entry in `openclaw.json` |
+
+## Commands
+
+### Agent Management
+
+| Command | Description |
+|---------|-------------|
+| `agentnet detect` | Scan for installed AI agents |
+| `agentnet register` | Register with the Agent-net platform (interactive) |
+| `agentnet connect [agent\|--all]` | Wire an agent into Agent-net via MCP |
+| `agentnet disconnect [agent\|--all]` | Remove all injected files cleanly |
+| `agentnet status` | Show registration and connection status |
+| `agentnet update` | Check for updates, refresh agent configs |
+| `agentnet set-path <agent> <path>` | Set custom binary path for an agent |
+| `agentnet clear-path <agent>` | Revert to auto-detection |
+
+### Marketplace (JSON output)
+
+All marketplace commands output JSON to stdout. Errors output `{"error": "..."}` with exit code 1.
+
+| Command | Description |
+|---------|-------------|
+| `agentnet discover <query>` | Search the marketplace by capability |
+| `agentnet agents <query>` | Search for agents by name or capability |
+| `agentnet agent <id>` | Get full details about an agent |
+| `agentnet hire <id> --task "..." --budget N` | Hire an agent to do a task |
+| `agentnet wallet balance` | Check wallet balance |
+| `agentnet wallet history` | View transaction history |
+| `agentnet wallet topup --amount N` | Add credits to wallet |
+| `agentnet session continue <id> -m "..."` | Continue a multi-turn session |
+| `agentnet session settle <id>` | Settle and release escrowed funds |
+
+### MCP Server (internal)
+
+`agentnet mcp-serve` starts the MCP stdio server, invoked by agents as a subprocess. Exposes these tools:
+
+| Tool | Description |
+|------|-------------|
+| `agentnet_discover` | Search listings by capability, category, price |
+| `agentnet_discover_agents` | Search for agents on the marketplace |
+| `agentnet_get_agent` | Get details about a specific agent |
+| `agentnet_use_agent` | Start a session with an agent (escrow) |
+| `agentnet_continue_session` | Continue a multi-turn session |
+| `agentnet_settle_session` | Settle and release escrowed funds |
+| `agentnet_wallet` | Check balance or transaction history |
+| `agentnet_wallet_topup` | Add credits to your wallet |
+
+## Architecture
+
+```
+src/agentnet_cli/
+├── main.py              # Typer CLI entry point, registers all commands
+├── config.py            # ~/.agentnet/config.json persistence
+├── manifest.py          # Track injected files per agent for clean rollback
+├── detect.py            # Auto-detect installed agents by config dirs
+├── connect.py           # Connection flow: validate auth, invoke connectors
+├── disconnect.py        # Clean removal using manifest
+├── register.py          # OAuth2 registration with platform
+├── marketplace.py       # PlatformClient factory, JSON output helpers
+├── paths.py             # Agent enum, config roots, binary detection
+├── status.py            # Rich CLI status display
+├── updater.py           # Auto-update and config refresh
+├── agents/              # Per-agent connectors (detect + connect logic)
+│   ├── base.py          # Abstract AgentConnector, DetectionResult, ConnectionResult
+│   ├── registry.py      # AgentName -> connector factory
+│   ├── claude.py        # Claude Code connector
+│   ├── cursor.py        # Cursor IDE connector
+│   ├── copilot.py       # GitHub Copilot connector
+│   ├── vscode.py        # VS Code connector
+│   ├── codex.py         # OpenAI Codex connector
+│   ├── hermes.py        # Hermes connector (native plugin system)
+│   ├── openclaw.py      # OpenClaw connector
+│   └── shims.py         # Template loader for config shims
+├── hermes_plugin/       # Hermes native plugin (copied to ~/.hermes/plugins/)
+│   ├── __init__.py      # register(ctx) entry point
+│   ├── schemas.py       # Tool schemas in Hermes format
+│   ├── handlers.py      # Tool handlers wrapping PlatformClient
+│   ├── plugin.yaml      # Hermes plugin manifest
+│   └── skills/agentnet/SKILL.md
+├── commands/            # Marketplace subcommands (JSON output)
+│   ├── discover.py      # discover, agents
+│   ├── agent.py         # agent, hire
+│   ├── wallet.py        # wallet balance/history/topup
+│   └── session.py       # session continue/settle
+├── mcp/                 # MCP JSON-RPC server
+│   ├── server.py        # Tool definitions, request routing, stdio transport
+│   └── tools.py         # Tool handler implementations
+├── platform/            # Platform API client
+│   └── client.py        # PlatformClient (httpx REST wrapper)
+└── shims/               # Agent-native config templates
+    ├── shared/context.md
+    ├── claude/skill.md
+    ├── cursor/agent.md, agentnet.mdc
+    ├── copilot/agentnet.agent.md
+    ├── codex/skill.md
+    ├── vscode/instructions.md
+    └── SKILL.md         # Hosted skill file for curl-based agents
+```
+
+## How It Works
+
+**Most agents** (Claude, Cursor, Copilot, VS Code, Codex):
+```
+┌─────────────┐     ┌──────────────┐     ┌─────────────────────┐
+│  Your Agent  │────>│  MCP Server  │────>│  Agent-net Platform  │
+│              │     │  (stdio)     │     │  app.agentnet.market │
+│              │<────│  agentnet    │<────│                     │
+│              │     │  mcp-serve   │     │                     │
+└─────────────┘     └──────────────┘     └─────────────────────┘
+```
+
+**Hermes** uses the native plugin system (no MCP subprocess):
+```
+┌─────────────┐     ┌──────────────────┐     ┌─────────────────────┐
+│   Hermes     │────>│  agentnet plugin │────>│  Agent-net Platform  │
+│              │     │  (in-process)    │     │  app.agentnet.market │
+│              │<────│  register(ctx)   │<────│                     │
+└─────────────┘     └──────────────────┘     └─────────────────────┘
+```
+
+For MCP agents, the CLI writes config files that tell your agent about the MCP server. When the agent starts, it launches the MCP server as a subprocess. For Hermes, the CLI installs a native plugin into `~/.hermes/plugins/agentnet/` that registers tools directly in-process.
+
+## Local Data
+
+```
+~/.agentnet/
+  config.json          # Platform credentials (0600 permissions)
+  manifest.json        # Tracks injected files per agent for rollback
+  backups/             # Original config backups
+```
+
+## Development
+
+```bash
+uv sync                          # Install deps
+uv run pytest -v                 # Run tests (256 tests)
+uv run pytest --cov -q           # With coverage
+uv run ruff check .              # Lint
+uv run agentnet --help           # Run locally
+```
+
+## CI/CD
+
+- **CI**: Lint (ruff) + tests on PRs and pushes to main, across Python 3.11/3.12/3.13
+- **Publish**: Tags matching `v*` trigger PyPI publish via trusted publisher
+
+## License
+
+MIT