feat: implement use-agently doctor command (USE-8)

Co-authored-by: fuxingloh <4266087+fuxingloh@users.noreply.github.com>

Author: Copilot

README.md

@@ -16,6 +16,9 @@ npm install -g use-agently
 # Initialize a new wallet
 use-agently init
 
+# Run environment checks
+use-agently doctor
+
 # Check your wallet info
 use-agently whoami
 
@@ -40,6 +43,23 @@ use-agently init
 use-agently init --regenerate  # Backup existing config and generate a new wallet
 ```
 
+### `doctor`
+
+Run environment checks to verify your setup is working correctly.
+
+```bash
+use-agently doctor
+use-agently doctor --rpc https://mainnet.base.org  # Use a custom RPC URL for network check
+```
+
+Checks:
+
+- Wallet is configured
+- Wallet is loadable (private key is valid)
+- Network is reachable (Base RPC)
+
+Exits with a non-zero status code if any check fails.
+
 ### `whoami`
 
 Show current wallet type and address.

packages/use-agently/src/cli.ts

@@ -4,6 +4,7 @@ import { whoamiCommand } from "./commands/whoami.js";
 import { balanceCommand } from "./commands/balance.js";
 import { agentsCommand } from "./commands/agents.js";
 import { a2aCommand } from "./commands/a2a.js";
+import { doctorCommand } from "./commands/doctor.js";
 
 export const cli = new Command();
 
@@ -14,3 +15,4 @@ cli.addCommand(whoamiCommand);
 cli.addCommand(balanceCommand);
 cli.addCommand(agentsCommand);
 cli.addCommand(a2aCommand);
+cli.addCommand(doctorCommand);

packages/use-agently/src/commands/doctor.ts

@@ -0,0 +1,69 @@
+import { Command } from "commander";
+import { createPublicClient, http } from "viem";
+import { base } from "viem/chains";
+import { loadConfig } from "../config.js";
+import { loadWallet } from "../wallets/wallet.js";
+
+const PASS = "✓";
+const FAIL = "✗";
+
+interface Check {
+  name: string;
+  ok: boolean;
+  message?: string;
+}
+
+export const doctorCommand = new Command("doctor")
+  .description("Run environment checks and report any issues")
+  .option("--rpc <url>", "Custom RPC URL to use for network check")
+  .action(async (options: { rpc?: string }) => {
+    const checks: Check[] = [];
+
+    // Check 1: config file exists and has a wallet
+    const config = await loadConfig();
+    const hasWallet = !!config?.wallet;
+    checks.push({
+      name: "Wallet configured",
+      ok: hasWallet,
+      message: hasWallet ? undefined : "No wallet found. Run `use-agently init` to create one.",
+    });
+
+    // Check 2: wallet is loadable (private key is valid)
+    let walletOk = false;
+    let walletMessage: string | undefined;
+    if (hasWallet) {
+      try {
+        const wallet = loadWallet(config.wallet);
+        walletOk = !!wallet;
+      } catch (err) {
+        walletMessage = err instanceof Error ? err.message : String(err);
+      }
+    } else {
+      walletMessage = "Skipped (no wallet configured).";
+    }
+    checks.push({ name: "Wallet loadable", ok: walletOk, message: walletMessage });
+
+    // Check 3: network reachable (RPC endpoint)
+    let networkOk = false;
+    let networkMessage: string | undefined;
+    try {
+      const client = createPublicClient({ chain: base, transport: http(options.rpc) });
+      await client.getChainId();
+      networkOk = true;
+    } catch (err) {
+      networkMessage = err instanceof Error ? err.message : String(err);
+    }
+    checks.push({ name: "Network reachable (Base RPC)", ok: networkOk, message: networkMessage });
+
+    // Print results
+    let allOk = true;
+    for (const check of checks) {
+      const icon = check.ok ? PASS : FAIL;
+      console.log(`${icon} ${check.name}${check.message ? `: ${check.message}` : ""}`);
+      if (!check.ok) allOk = false;
+    }
+
+    if (!allOk) {
+      process.exit(1);
+    }
+  });

skills/use-agently/SKILL.md

@@ -32,10 +32,11 @@ This generates a local EVM private key and saves it to `~/.use-agently/config.js
 ## Core Workflow
 
 1. **Initialize**: `use-agently init` — Create a local EVM wallet
-2. **Fund**: Send USDC (on Base) to the wallet address shown
-3. **Discover**: `use-agently agents` — Browse available agents on Agently
-4. **Communicate**: `use-agently a2a <agent-url> -m "message"` — Send messages to agents
-5. **Check balance**: `use-agently balance` — Monitor on-chain funds
+2. **Verify**: `use-agently doctor` — Check your environment is set up correctly
+3. **Fund**: Send USDC (on Base) to the wallet address shown
+4. **Discover**: `use-agently agents` — Browse available agents on Agently
+5. **Communicate**: `use-agently a2a <agent-url> -m "message"` — Send messages to agents
+6. **Check balance**: `use-agently balance` — Monitor on-chain funds
 
 ## Commands
 
@@ -48,6 +49,15 @@ use-agently init --regenerate       # Backup existing config and create new wall
 
 Wallet config is stored at `~/.use-agently/config.json`. Using `--regenerate` creates a timestamped backup before generating a new wallet.
 
+### Environment Check
+
+```bash
+use-agently doctor                  # Run all environment checks
+use-agently doctor --rpc <url>      # Use a custom RPC URL for the network check
+```
+
+Checks wallet configuration, wallet validity, and network reachability. Exits with a non-zero status code if any check fails.
+
 ### Wallet Info
 
 ```bash