Support Center

How can we help?

Search our docs, browse FAQs, or chat with Mesh — our AI support agent.

Browse FAQ
Answers to the most common questions about AISP protocol, pricing, and integrations.
View all questions →
Contact Support
Submit a ticket or use Mesh chat. Response targets are confirmed in the assisted-beta offer or SOW.
Send a message →
Status Page
Live status of all AISP services — API, hub, auth, and more. Subscribe to updates.
View status →

Recent Updates

View all →
v0.2.0April 6, 2026
Referral system, corporate pages, and marketing stack
  • +Referral program
  • +Install page with OS detection
  • +Status, Changelog, Security pages
  • +Newsletter and social proof
v0.1.1March 20, 2026
Bug fixes and performance
  • +Fixed session discovery race condition
  • +Corrected mDNS TTL on macOS Sequoia
  • +Hub memory usage reduced 40%
v0.1.0March 1, 2026
Initial release
  • +Protocol v1.0 spec (CC-BY-4.0)
  • +File + mDNS transports
  • +Ed25519 signing
  • +Go SDK and npm package

Common Issues

Full FAQ →
Capability Negotiation Version Mismatch
SymptomsClient prints 'NegotiationFailedError: protocol version mismatch (client: 1.2, server: 1.1)' and disconnects immediately.
FixSet the client to use the server's protocol version, or upgrade the server. Command: aispctl connect --endpoint wss://server:8443/aisp --protocol-version 1.1 If upgrade is preferred: aispctl server upgrade --version 1.2
File‑Based Context Transfer Permission Error
SymptomsContext transfer fails with 'Permission denied: /var/lib/aisp/context/transfer/session123.ctx'.
FixChange ownership and permissions of the transfer directory. Command: sudo chown -R aisp:aisp /var/lib/aisp/context/transfer sudo chmod 750 /var/lib/aisp/context/transfer
Unix Socket Binding Failure Due to Stale Socket
SymptomsStarting AISP on a Unix socket fails with 'Error: Address already in use (EADDRINUSE) on /tmp/aisp.sock'.
FixRemove the stale socket and restart the service. Command: rm /tmp/aisp.sock && aispctl start --socket /tmp/aisp.sock
HTTP Route Not Registered (404)
SymptomsDelegation via HTTP returns 'HTTP 404 Not Found – route /delegate not registered'.
FixEnable the delegate route in the HTTP configuration file and restart the HTTP adapter. Command: # Edit /etc/aisp/http.yaml adapters: http: routes: - path: /delegate method: POST handler: delegate # Restart the adapter sudo systemctl restart aisp-http
Stdio Mode Drops Messages Without Newline Delimiter
SymptomsMessages sent via stdin are not received; logs show 'Invalid frame: missing newline'.
FixEnsure each message ends with a newline. Command: echo -e "Hello\n" | aispctl stdio send --session-id abc123
Discovery Not Finding Agents Because of Multicast Filtering
Symptoms`aispctl discover` reports 'No agents found' even though peers are up.
FixAllow multicast traffic for discovery, or switch to static peer list. Command: # Allow mDNS multicast on firewalld sudo firewall-cmd --add-port=5353/udp --permanent sudo firewall-cmd --reload # Or use static discovery aixspctl config set discovery.mode static aixspctl config set discovery.peers ["192.0.2.10","192.0.2.11"]
Task Delegation Timeout Due to Exceeding Max Depth
SymptomsDelegation fails with 'TimeoutError: delegation did not complete within 30s'.
FixIncrease the max_depth limit or redesign tasks to avoid deep chaining. Command: aixspctl config set delegation.max_depth 5 sudo systemctl restart aisp

Contact Support

Team+ customers get 48-hour response. Community tier: check Discord first.

Chat with Mesh

Mesh can help triage common questions. Assisted-beta responses are reviewed before production guidance.

Assisted-beta responses are reviewed before production guidance