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
ESC