DEV Community

João André Gomes Marques
João André Gomes Marques

Posted on

Verify AI Agent Signatures from Your Terminal

#ai #python #tutorial #cli

Sometimes you just want to check a signature from the command line. No code, no scripts.

pip install asqav[cli]
Enter fullscreen mode Exit fullscreen mode

Verify a signature 

asqav verify sig_abc123
Enter fullscreen mode Exit fullscreen mode

Output:

Signature: sig_abc123
Agent: research-bot
Action: api:call
Signed: 2026-03-26T14:30:00Z
Status: VERIFIED
Enter fullscreen mode Exit fullscreen mode

No API key needed. Verification is a public endpoint.

Manage agents 

# List your agents
asqav agents list

# Create a new one
asqav agents create my-new-agent
Enter fullscreen mode Exit fullscreen mode

These need your API key set as ASQAV_API_KEY.

Offline mode

Sign actions when the API is down. They queue locally and sync later.

# Queue is stored at ~/.asqav/queue/
asqav queue count    # see pending items
asqav queue list     # see what's queued
asqav sync           # push to API when back online
Enter fullscreen mode Exit fullscreen mode

Failed items stay in the queue. Successful ones get removed. Run asqav sync again to retry.

In scripts 

from asqav import local_sign

# Sign offline
local_sign("agt_xxx", "batch:complete", {"records": 5000})
Enter fullscreen mode Exit fullscreen mode

The CLI is built with Typer. Clean help text, colored output, proper exit codes.

SDK docs | GitHub

Top comments (0)