Repository navigation
clawgate-v0.3.1
ClawGate v0.3.1 Release Notes
This release adds tokenless tool discovery via tool remote-list,
letting agents discover all registered tools without requiring any
capability token or grant. It also improves audit logging for
discovery requests and adds security hardening tests for the
tokenless IPC path.
Tokenless Tool Discovery
clawgate tool remote-list can be used by the agent to discover tools
registered on the primary stystem, granted or not.
The command is purely metadata - it returns tool names and
descriptions, never executes anything. The resource daemon returns
all registered tools unconditionally.
# No grant needed - just run it
clawgate tool remote-listcalc Calculator (bc)
catnum Cat with line numbers
How It Works
- CLI sends a tokenless
{"op":"tool_list","params":{}}via IPC - Agent daemon detects the tokenless request and forwards it to
the resource daemon over the E2E encrypted TCP connection - Resource daemon intercepts the tokenless
tool_listrequest
before token validation and returns all registered tools - Actual tool invocation still requires a properly scoped token
MCP Integration
The clawgate_tool_list MCP tool also works without tokens - it
uses the same tokenless discovery path.
Audit Log Improvements
Discovery requests produce clean audit entries:
2026-02-08T12:00:00Z AUDIT req=discovery op=tool_list path=- success=true
Security Hardening
Added 8 integration tests verifying that the tokenless IPC path
cannot be exploited:
- Tokenless
read,write,git,tool,list,statrequests
are all rejected with "Token required" - Empty tokenless requests are rejected
tool_listresponses cannot leak file contents
Modified Files
| File | Changes |
|---|---|
src/resource/handlers.zig |
Tokenless tool_list interception before parseRequest |
src/resource/audit_log.zig |
Proper audit entries for tokenless discovery |
src/agent/daemon.zig |
Tokenless IPC detection, simplified handleToolListDiscovery |
src/agent/mcp.zig |
Tokenless clawgate_tool_list MCP tool |
src/cli/tool_cmd.zig |
Tokenless handleRemoteList |
docs/TOOL-GUIDE.md |
Updated discovery docs (no token required) |
testing/test_tools.sh |
New tokenless security tests |