Skip to content
nara Documentation

Local Testing

Testing Local-first
Section titled “Recommended loop”
  1. Generate or update implementations with edge-connector generate.
  2. Write or adjust your tool logic.
  3. Run edge-connector test with representative JSON arguments.
  4. Inspect the structured result and any logs from your system.
  5. Iterate until the behavior matches expectations, then package and upload.

edge-connector test

Section titled “edge-connector test”
Terminal window
edge-connector test \
  --implementations ./custom-implementations \
  --tool my_tool \
  --args '{"example": "value"}'

What the command does:

  • loads your compiled implementations via the dynamic tool loader,
  • optionally connects to Tool RPC to fetch tool definitions and context,
  • executes the selected tool and prints the JSON result.

If --args is omitted, the command launches a small editor so you can provide JSON interactively.

Testing against Tool RPC

Section titled “Testing against Tool RPC”

When --url, --host, or --port are supplied, the command:

  • connects to the configured Tool RPC server as a DESKTOP client,
  • filters tools that are allowed to run on EDGE/DESKTOP and have local implementations,
  • lets you select a tool (if not provided),
  • executes it with a realistic context (including organization and user identifiers derived from the auth token).