rad_remote_list
List remote repositories connected to a Radicle project to manage collaboration links and track peer connections.
Instructions
List remotes in a Radicle repository.
Args:
repository_path: Path to the repository (default: current directory)Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| repository_path | No | . |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/radicle_mcp/server.py:236-252 (handler)The handler function for rad_remote_list tool. It executes the 'rad remote' command using the run_rad_command helper and formats the output. Registered via @mcp.tool() decorator.
@mcp.tool() async def rad_remote_list(repository_path: str = ".") -> str: """ List remotes in a Radicle repository. Args: repository_path: Path to the repository (default: current directory) """ result = await run_rad_command(["rad", "remote"], cwd=repository_path) if result["success"]: if result["stdout"]: return f"🌐 Remotes in repository:\n{result['stdout']}" else: return "🌐 No remotes found in repository" else: return f"❌ Failed to list remotes: {result['stderr']}" - src/radicle_mcp/server.py:37-85 (helper)Shared helper function used by multiple radicle tools, including rad_remote_list, to execute 'rad' CLI commands asynchronously.
async def run_rad_command(command: List[str], cwd: Optional[str] = None) -> Dict[str, Any]: """ Run a rad command and return the result. Args: command: List of command arguments starting with 'rad' cwd: Working directory to run the command in Returns: Dictionary with stdout, stderr, and return_code """ try: # Ensure command starts with 'rad' if not command or command[0] != "rad": command = ["rad"] + command logger.info(f"Running command: {' '.join(command)}") process = await asyncio.create_subprocess_exec( *command, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.PIPE, cwd=cwd ) stdout, stderr = await process.communicate() return { "stdout": stdout.decode("utf-8").strip(), "stderr": stderr.decode("utf-8").strip(), "return_code": process.returncode, "success": process.returncode == 0 } except FileNotFoundError: return { "stdout": "", "stderr": "rad command not found. Please ensure Radicle is installed.", "return_code": 127, "success": False } except Exception as e: return { "stdout": "", "stderr": f"Error running command: {str(e)}", "return_code": 1, "success": False }