Installation Guide
This guide covers the progressive installation of ANOLISA — from the CLI tool to individual components and adapter setup.
Step 1: Install the ANOLISA CLI
The anolisa CLI is the unified entry point for managing all ANOLISA components.
Option A: Install script (recommended)
curl -fsSL https://agentic-os.sh | sh
Option B: YUM (Alinux)
sudo yum install anolisa
After installation, verify:
anolisa --version
Step 2: Environment Detection
Run the environment check to identify your system capabilities:
anolisa env
This displays:
- OS and architecture
- Available filesystems (btrfs for ws-ckpt)
- FUSE availability (for skillfs)
- Installed Agent runtimes (cosh, OpenClaw, Hermes)
- Kernel features (eBPF for agentsight)
Step 3: Install Components
Install components individually based on your needs:
anolisa install <component>
Available Components
| Component | Description | Mode |
|---|---|---|
cosh | Copilot Shell — AI terminal assistant | user |
os-skills | System management and DevOps skills | user |
tokenless | Token optimization (compression) | user |
ws-ckpt | Workspace checkpoint/rollback | user |
skillfs | FUSE virtual skill filesystem | user |
agent-memory | MCP-based persistent memory | user |
agentsight | eBPF tracing and dashboard | system |
agent-sec-core | Security hardening | system |
Note: Components marked system require
sudo:bash sudo anolisa install agentsight
Install All Components
anolisa install --all
YUM Alternative (Alinux)
For each component, you can also use YUM:
sudo yum install <component>
Step 4: Adapter Setup
Adapters bridge components to specific Agent frameworks. Scan declarations after installing a component, then enable the adapter for a detected framework:
anolisa adapter scan
anolisa adapter enable <component> [framework]
Examples
# Tokenless plugin for OpenClaw
anolisa adapter enable tokenless openclaw
# ws-ckpt plugin for Hermes
anolisa adapter enable ws-ckpt hermes
Step 5: Verify Installation
Check the status of all installed components:
anolisa status
Run the built-in diagnostic:
anolisa doctor
Uninstallation
Remove a specific component:
anolisa uninstall <component>
Repeat the command for each component you want to remove. uninstall does not
provide an --all option.
Upgrade
Update a specific component:
anolisa update <component>
Update all installed components:
anolisa update --all