actx query

actx query

Execute a CTX query directly from the command line. Useful for development, debugging, and quick one-off operations.

Usage

actx query <ctx>

Arguments

Argument	Required	Description
ctx	✅	A CTX statement string (must be quoted in the shell)

What It Does

1. Loads .context/actx.yaml configuration
2. Initializes CryptoManager (Ed25519 keypair)
3. Initializes storage, memory, and knowledge planes
4. Builds a full Gateway instance
5. Parses the CTX statement
6. Signs and writes a sidecar translation
7. Processes through the gateway pipeline
8. Outputs the structured result

Examples

Search tools

$ actx query '?t github'
📝 Parsed CTX:
{
  "operator": "?",
  "plane": "t",
  "target": "github",
  "filters": []
}

🗣️  Human: Searched for tools matching "github"
   (Signed: a1b2c3d4...)

📤 Result:
{
  "ok": true,
  "op": "?t",
  "ms": 4,
  "data": { "results": [...], "count": 5 }
}

Store a memory

actx query '+m "auth-decision" #arch "JWT for API endpoints"'

Search knowledge

actx query '?k "authentication" #code @7d ^3'

Call a tool

actx query '>t github.issues.list state="open" ^5'

Output

The command outputs three sections:

1. Parsed CTX — the typed AST from the parser
2. Human translation — the sidecar’s English translation with Ed25519 signature digest
3. Gateway result — the structured GatewayResult from processing

Notes

• Quote the CTX string in the shell to prevent >, #, *, and ^ from being interpreted
• The command initializes and shuts down the full gateway for each invocation
• For persistent connections, use actx start instead

See Also

• actx start — persistent gateway for multiple queries
• CTX Language — learn the full syntax