Aside Codemode
One call where Aside used to spend fifty — rg-backed search, Aside-shaped file tools, and batched browser work inside a single sandboxed JavaScript block. On a real folder, 55s of find+grep became ...
Overview
Aside Codemode (aside-codemode) exposes Aside's native sandboxed JavaScript REPL and bundled ripgrep 15.2 (PCRE2) engine through a single high-efficiency code-mode tool (execute_code). Instead of burning 50 separate model tool calls and flooding conversation context with raw HTML or grep output, agents search 127,000-file trees in ~2 seconds and compress multi-page browser reads by 421x before returning concise typed results.
How It Works
Aside Codemode operates through structured, deterministic execution stages:
browse.exec session, compressing 1.87 MB of raw HTML into 4.4 KB of typed structured rows before reaching the LLM.execute_code MCP tool for Aside accounts or operates through an explicit CLI runner with automated backup rollbacks.Key Technical Features & Capabilities
find+grep into ~1s.browse.exec and returns only extracted structured rows (e.g., compressing 1.87 MB HTML into 4.4 KB typed JSON).codemode --install-mcp, automatically locating Aside's vendored PCRE2 ripgrep binary on macOS and Windows.rolledBack protection) and diagnoses activated vs stale-entry account health via codemode --doctor.Architecture & Technology Stack
mcp__aside-codemode__execute_code)aside repl Playwright/Snapshot Cache Engine (session.js / script.js)System Requirements
| Specification | Minimum Requirement | Recommended Specification |
|---|---|---|
| Operating System | macOS 12+ & Windows 10/11 (Node.js >= 18) | Latest stable release build |
| Processor Architecture | 4-Core x86_64 or Apple Silicon M1 | 8-Core Apple Silicon / Core i7+ |
| Memory (RAM) | 4 GB Unified Memory | 16 GB+ High-Speed RAM |
| Disk Space | 1 GB free SSD storage | 5 GB+ free SSD storage |
Installation & Setup Guide
Native MCP Installation (Recommended)
npm install -g aside-codemode codemode --install-mcp codemode --doctor
Source Installation
git clone https://github.com/lidge-jun/aside-codemode.git cd aside-codemode npm install -g . codemode --doctor
Installation & Setup Guide
Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.
How to Use & Workflow
codemode --install-mcp (or pass --account u1 --force when preserving multiple active MCP servers).codemode --doctor to confirm activated status and valid rg binary resolution.mcp__aside-codemode__execute_code to run search.content or search.count in one turn.browse.exec({ urls, extract }) pipelines returning clean JSON arrays directly to model context.How to Use & Workflow
Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.
Troubleshooting & Common Issues
codemode --install-mcp aborts due to other enabled MCP servers.**set() clears cached tool inventories across existing servers unless explicitly confirmed.codemode --install-mcp --account u1 --force which saves an automatic settings.json.codemode-bak-* rollback snapshot.rg on system PATH.CODEMODE_RG=/abs/path/to/rg.How to Use & Getting Started
How to Use & Getting Started
Unlock this app with 5 Redit to access verified runbooks and usage workflows.
Ready to run Aside Codemode?
100% Free & Open-Source native desktop software. Star the repository to support development.
More in ai-automation
View all ai-automation apps →
CodexClaw
Development discipline + multi-model subagents for OpenAI Codex — 13 dev skills, PABCD workflow, repo map, recall, skill search. Single plugin, no external harness.
AGBrowse
Ultimate browser automation toolkit for AI agents. Zero MCP token tax, JS evaluate, vision-click with DPR correction.
CLI JAW
2-line install personal AI assistant. 11 AI runtime surfaces (Claude, Codex, Cursor, Gemini, Grok, Antigravity, OpenCode, Copilot), 200+ skills, zero ban risk.