MICROBIX DOCUMENTATION · CLI v1.0.36

Developer documentation

Install Aether, connect your account, and find the commands and API examples you need.

TERMINAL TOOL SPECIFICATION

Aether Code CLI (`microbix-aether`)

Aether Code CLI runs in your terminal. It reads and edits project files, runs tests, and asks for confirmation before changing code.

1. Global Installation npm · v1.0.36
npm install -g microbix-aether@latest

Installs the global aether executable in your system path. Requires Node.js 18.0 or higher.

2. Launching, Resuming & Authentication CLI Flags
# Start a new interactive session
aether
# Resume an interrupted session after Ctrl+C or crash
aether --resume <session_id>
# Force immediate re-authentication via 6-digit PIN
aether --login
Authentication credentials are encrypted and stored at ~/.aether_auth with 0600 permissions. You can also export an environment variable: export AETHER_AUTH_TOKEN="your_token".
3. In-Session Slash Commands 9 Verified Commands
Command Syntax Functionality
/help /help Displays complete command list and runtime environment status
/login /login Starts interactive 6-digit terminal PIN or Magic Link pairing flow
/switch /switch Switches between active cloud workspaces and project directories
/logout /logout Deletes ~/.aether_auth and revokes the active session token
/model /model [name] Changes the AI model (e.g. aether-ultra)
/plan /plan <objective> Creates a step-by-step coding plan without changing files
/training /training Shows model training results, saved-model error measurements, and usage data
/clear /clear Clears the terminal viewport and resets active context window memory
/agent /agent <task> Starts a coding task that can use tools over several steps
4. Native Agent Tools (Source Ground Truth) 6 Built-in Tools
Tool Parameters Behavior & Security Constraints
read_file path, offset, limit UTF-8 stream reader capped at 5,000 characters per call to protect context
create_file path, content Atomic writer creating parent directories. Triggers approval gate
replace_file path, target, replacement Replaces selected code and shows the changes
delete_file path Unlinks file from disk. Requires mandatory human approval
search_file query, path Searches project files and returns matching line numbers
run_command command Executes build/test commands with real-time stdout/stderr streaming
5. Approving changes Security Gate

To prevent accidental destruction or privilege escalation, Aether CLI intercepts all destructive actions and prompts the user directly in stdout:

+- ACTION PROPOSED BY AETHER AGENT ------------------------+
¦ Tool: replace_file
¦ File: src/auth/jwt.service.ts (lines 42-58)
¦ Diff: - old_verify_token() + new_rotating_verify()
+----------------------------------------------------------+
Execute this action on disk? [1] Approve [2] Reject
API for model requests cURL · bash
curl -X POST https://api.microbix.in/api/chat \
  -H "Authorization: Bearer YOUR_MICROBIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aether-ultra",
    "messages": [
      {"role": "user", "content": "Inspect latency bottleneck in database connection pool."}
    ],
    "stream": true
  }'
Full request schema & endpoints: View REST API Reference ?

Official Client Libraries

Node.js / TypeScript SDK npm install @microbix/sdk
Python Client Library pip install microbix
ESC