Developer documentation
Install Aether, connect your account, and find the commands and API examples you need.
Aether Code CLI
Install with npm, work on your code, and review changes before they are saved.
REST API Reference
Find API endpoints, authentication instructions, request formats, and streaming examples.
CLI Pairing
Connect your terminal to the web workspace with a six-digit PIN or sign-in link.
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.
npm install -g microbix-aether@latest
Installs the global aether executable in your system path. Requires Node.js 18.0 or higher.
aether
aether --resume <session_id>
aether --login
~/.aether_auth with 0600 permissions. You can also export an environment variable: export AETHER_AUTH_TOKEN="your_token".
| 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 |
| 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 |
To prevent accidental destruction or privilege escalation, Aether CLI intercepts all destructive actions and prompts the user directly in stdout:
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
}'
Official Client Libraries
npm install @microbix/sdk
pip install microbix