๐ŸŽ Get the FREE AI Skills Starter Guide โ€” Subscribe โ†’
BytesAgainBytesAgain
BytesAgain โ€บ Skills โ€บ Cogmate Client
๐Ÿฆ€ ClawHub

Cogmate Client

by @maxiiwang

Access and query Cogmate personal knowledge systems for knowledge retrieval, semantic search, and Q&A using a valid CogNexus access token.

Versionv1.0.1
Downloads1,066
#crypto-defi#database#legal
TERMINAL
clawhub install cogmate-client

๐Ÿ“– About This Skill

name: cogmate-client description: Access Cogmate personal knowledge systems via API. Use when querying someone's Cogmate/ๆจกๆ‹Ÿไธ–็•Œ for knowledge retrieval, semantic search, or Q&A. Requires valid access token from CogNexus (https://github.com/MaxiiWang/CogNexus). Triggers on: "ask Cogmate", "query knowledge base", "search Cogmate", "access ๆจกๆ‹Ÿไธ–็•Œ".

Cogmate Client

Connect to Cogmate instances for knowledge retrieval and Q&A.

Prerequisites

  • Valid access token (obtain from CogNexus or instance owner)
  • Cogmate API endpoint URL

    • Quick Start

    Ask a Question

    curl -X POST "http://{COGMATE_URL}/api/ask?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"question": "ไฝ ็š„้—ฎ้ข˜"}'

    Semantic Search

    curl "http://{COGMATE_URL}/api/visual/facts?token=YOUR_TOKEN&search=ๅ…ณ้”ฎ่ฏ"

    API Reference

    Authentication

    All protected endpoints require token as query parameter (not JSON body).

    Endpoints

    | Endpoint | Method | Description | |----------|--------|-------------| | /api/ask | POST | Ask questions, get AI-powered answers | | /api/visual/facts | GET | Browse/search knowledge facts | | /api/visual/stats | GET | Get knowledge base statistics | | /api/visual/graph | GET | Get knowledge graph data | | /api/hub/profile | GET | Get Cogmate profile (public) |

    POST /api/ask?token=YOUR_TOKEN

    Ask a question against the knowledge base.

    Request: 

    {
  "question": "What do you know about X?"
}

    Response: 

    {
  "answer": "Based on the knowledge base...",
  "sources": [{"id": "fact_xxx", "summary": "..."}]
}

    GET /api/visual/facts

    Browse or search facts.

    Parameters:

  • token (required): Access token
  • search (optional): Search query
  • layer (optional): Filter by layer (fact/connection/abstract)

    • GET /api/visual/stats

    Get statistics about the knowledge base.

    Response: 

    {
  "facts": 87,
  "connections": 45,
  "abstracts": 12
}

    Token Permissions

    | Scope | Capabilities | |-------|-------------| | full | Complete access: browse, ask, view private | | qa_public | Q&A only (may have usage limits) | | browse_public | Browse public facts only |

    Helper Scripts

    Ask Question

    ./scripts/ask.sh   "Your question"

    Search Knowledge

    ./scripts/search.sh   "search term"

    Getting Access

    1. Visit the Cogmate owner's CogNexus marketplace listing 2. Purchase a token with ATP (platform credits) 3. Use the token to access the Cogmate API

    Error Handling

    | Status | Meaning | |--------|---------| | 401 | Invalid or expired token | | 403 | Insufficient permissions | | 429 | Rate limit exceeded | | 500 | Server error |

    Example Workflow

    import requests
    COGMATE_URL = "http://example.com:8000"
TOKEN = "your_token_here"
    Ask a question (token in query params, question in body)
    
response = requests.post(
    f"{COGMATE_URL}/api/ask",
    params={"token": TOKEN},
    json={"question": "What are the key insights about X?"}
)
print(response.json()["answer"])
    Search facts
    
facts = requests.get(
    f"{COGMATE_URL}/api/visual/facts",
    params={"token": TOKEN, "search": "keyword"}
).json()
for fact in facts.get("facts", []):
    print(f"- {fact['summary']}")

    ๐Ÿ’ก Examples

    Ask a Question

    curl -X POST "http://{COGMATE_URL}/api/ask?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"question": "ไฝ ็š„้—ฎ้ข˜"}'

    Semantic Search

    curl "http://{COGMATE_URL}/api/visual/facts?token=YOUR_TOKEN&search=ๅ…ณ้”ฎ่ฏ"

    โš™๏ธ Configuration

  • Valid access token (obtain from CogNexus or instance owner)
  • Cogmate API endpoint URL