PACKAGE: microbix-aether@1.0.36
·
GLOBAL BINARY: aether
Aether Code CLI
Use Aether in your terminal to inspect projects, edit code, and run commands. Review and approve file changes before they are applied.
Global Installation
Node 18+ · Python 3.10+
$ npm install -g microbix-aether@latest
$ aether # Launch interactive shell
$ aether --resume <session_id> # Restore state
Terminal — Verified Execution Trace
agent.py & tools.py
$ aether
Aether Code CLI v1.0.36 — Microbix Research Labs
Verifying session via secure token vault (~/.aether_auth)...
? Device authenticated successfully. Active user: nidhish
Tier: Ultra | Token Ledger: 240.00 mX
?? Plan Mode is active (Ultra tier detected)
?- Aether Code (Ultra)
?-? /agent refactor authentication flow to use JWT
[Aether Agent] Checking project files and code...
[Aether Agent] Identified target: src/auth.js
ACTION APPROVAL REQUIRED: Agent requests to read file:
Target: src/auth.js
[1] Approve (Read) [2] Reject (Abort)
Select option: 1
ACTION APPROVAL REQUIRED: Agent requests targeted text replacement in:
File: src/auth.js
- const token = signLegacySession(user.id);
+ const { access, refresh } = issueTokenPair(user.id, user.role);
[1] Approve (Replace) [2] Reject (Abort)
Select option: 1
? Successfully replaced targeted block in src/auth.js. All 18 unit tests passing.
Commands you can use in a session
Commands available during an active interactive aether session, extracted from aether_cli/commands.py:
| Slash Command | Source Definition & Detailed Operation |
|---|---|
/help |
Displays the full built-in manual, command usage, model tiers, and keybindings. |
/login |
Initiates interactive device pairing using either a 6-digit PIN code or browser Magic Link. |
/switch |
Enables switching between multiple developer accounts saved in local credentials storage. |
/logout |
Clears the cached auth token from ~/.aether_auth and resets local state. |
/model |
Changes the active AI model. Available models depend on your plan: Lite, Classic, Pro, or Ultra. |
/plan |
Toggles Plan Mode. Formulates multi-phase execution roadmaps before modifying files. Auto-enabled for Pro & Ultra. |
/training |
Turns data collection for AI training on or off. The no-collection mode stops all prompt logging. |
/clear |
Clears the terminal screen buffer and flushes local conversation context memory. |
/agent <task> |
Starts a task that uses tools over several steps and asks for your approval along the way. |
What the agent can do
The agent uses these six tools to work on your project.
read_file
Reads file contents with a hard 5,000 character limit per call. Approval required.
Params: filepath (string)
create_file
Creates new files or overwrites existing files with content. Approval required.
Params: filepath (string), content (string)
replace_file
Targeted substring replacement with exact before/after diff confirmation.
Params: filepath, target, replacement
delete_file
Deletes files from disk. The default answer is no; you must approve the deletion.
Params: filepath (string)
search_file
Recursive directory search. Automatically ignores node_modules, .git, and __pycache__.
Params: query (string)
run_command
Executes shell commands in your local directory. Mandatory user confirmation.
Params: command (string)
Keeping sign-in details safe
All authentication tokens are persisted locally in your user home directory at ~/.aether_auth using strict 0600 file permissions (readable only by the local user). You may also inject the token directly in CI/CD pipelines using the AETHER_AUTH_TOKEN environment variable.
Token Verification Endpoint: POST https://auth.microbix.in/api/cli/verify