Skip to main content

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.

curl -fsSL https://get.agentic-os.sh | bash

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​

ComponentDescriptionSupported modes
coshCopilot Shell — AI terminal assistantuser, system
cosh-ngAI-native Linux terminal and deterministic Agent runtime (experimental)system
os-skillsSystem management and DevOps skillsuser, system
tokenlessToken optimization (compression)user, system
ws-ckptWorkspace checkpoint/rollbacksystem
skillfsFUSE virtual skill filesystemsystem
agent-memoryMCP-based persistent memoryuser, system
agentsighteBPF tracing and dashboardsystem
agent-sec-coreSecurity hardeningsystem

Note: System-only components require sudo and an explicit system scope: bash sudo anolisa --install-mode system install agentsight

Install cosh-ng in system mode, then start the terminal with cosh:

sudo anolisa --install-mode system install cosh-ng
cosh

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. Enable an adapter after installing the component:

anolisa adapter scan
anolisa adapter enable <component> [framework]

Examples​

# Tokenless hook for cosh
/usr/share/tokenless/scripts/install.sh --cosh

# Tokenless plugin for OpenClaw
/usr/share/tokenless/scripts/install.sh --openclaw

# ws-ckpt plugin for OpenClaw
ws-ckpt plugin install --runtime openclaw

# ws-ckpt plugin for Hermes
ws-ckpt plugin install --runtime 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>

There is no batch uninstall command. List the installed records, then remove each intended component explicitly so its authority and package-removal policy are reviewed independently:

anolisa list --installed
anolisa uninstall <component>

Upgrade​

Update a specific component:

anolisa update <component>

Update all installed components:

anolisa update all

update all updates recorded components but not the CLI binary. Use anolisa update self for the CLI.

Next Steps​