tykimos/agent-native-agent/install

install — ANA from zero to a running dashboard

ANA needs three things at runtime: Node ≥ 24, tmux, and a coding-agent CLI (Claude Code by default). Its one npm dependency, NodeRel, is installed from GitHub by install.sh (and by run.sh if it is missing). This skill checks the machine, installs what's missing, and starts ANA.

check-env.sh ──► install.sh ──► run.sh start ──► http://localhost:8809
 (report only)    (missing only,     tmux "base-ana-claude"      (dashboard)
                   idempotent)       tmux "srv-base-ana-claude"
Windows: install-wsl.ps1 ──► WSL Ubuntu ──► install.sh + run.sh (inside WSL)

All scripts live in skills/install/scripts/, and every one is safe to re-run.

Naming convention. Every ANA lives in ~/ana/<xxx>-ana (or /ana/<xxx>-ana); that folder name is the ANA's name (<xxx> may contain hyphens). The sample is ~/ana/base-ana. Agent tmux sessions are <xxx>-ana-<yyy> (yyy = claude, codex, or any hyphenated label), and only those appear in the chat's session list. A folder that doesn't end in -ana (e.g. a plain git clone into agent-native-agent) falls back to the name base-ana. Overrides: ANA_NAME, TMUX_SESSION, ANA_TMUX_ALL=1 (list every tmux session).

Workflow (follow in order)

1. Analyze the environment first. Never install blindly.

bash skills/install/scripts/check-env.sh

Read the ANA_ENV line and branch:

If you're in plain Windows PowerShell or cmd (no bash at all), go straight to Windows.

ready=yes → skip to step 3. ready=no → step 2. Tell the user what is missing before installing.

2. Install what's missing

bash skills/install/scripts/install.sh

The script needs sudo (Linux) or your password (Homebrew). This is interactive: if you are an agent running it, tell the user it will prompt, or have them run it with ! bash skills/install/scripts/install.sh. Outside the repo it clones into ANA_DIR (default ~/ana/base-ana; override ANA_REPO / ANA_DIR, keeping the ~/ana/<xxx>-ana form). Re-run check-env.sh afterwards; it must say ready=yes.

3. Run

bash skills/install/scripts/run.sh            # = start
bash skills/install/scripts/run.sh status     # agent/server sessions + URL + health
bash skills/install/scripts/run.sh stop

• The agent runs in tmux <name>-claude (the claude command; base-ana-claude for ~/ana/base-ana), and the server runs in tmux srv-<name>-claude (PORT=… ANA_NAME=<name> TMUX_SESSION=<name>-claude node server.js). The srv- prefix keeps the server out of the chat's session list. A server still running under the old name <session>-server is reused.
• If 8809 is busy, the next free port is used. status prints the real URL.
• Env overrides: ANA_NAME, TMUX_SESSION=name, PORT, AGENT_CMD="codex" (any agent CLI), BIND. A second agent for the same ANA: AGENT_CMD=codex TMUX_SESSION=base-ana-codex bash run.sh.
• First run: Claude Code needs a one-time login and a folder-trust confirmation. Tell the user to run tmux attach -t base-ana-claude (or <name>-claude), finish it, then detach with Ctrl-b d. Until then the dashboard loads but the agent can't answer.

4. Verify, then hand off

run.sh status must show health : HTTP 200. Give the user the URL and the three things they'll use:

1. Open the dashboard: http://localhost:<port>
2. Chat: the chat icon (bottom right) is always there. Turn on Chip (top right) to click dashboard elements into context chips.
3. Watch the agent directly: tmux attach -t base-ana-claude

Windows (WSL)

tmux does not run natively on Windows. ANA runs inside WSL, and the Windows browser reaches it at localhost (WSL2 forwards ports automatically).

1. Open PowerShell as Administrator (only needed the first time) in the repo folder, or download just the script:

``powershell powershell -ExecutionPolicy Bypass -File skills\install\scripts\install-wsl.ps1 ``

1. If WSL/Ubuntu isn't installed yet, the script runs wsl --install -d Ubuntu. Reboot if asked, open "Ubuntu" from the Start menu once to create the Linux user, then run the script again. No admin is needed the second time.
2. On the second run it goes into Ubuntu, installs git, clones the repo into ~/ana/base-ana (the Linux home, not /mnt/c), runs install.sh, then run.sh start.
3. Open http://localhost:8809 in the Windows browser. Log the agent in with wsl -d Ubuntu -- tmux attach -t base-ana-claude.

Manual equivalent (already inside an Ubuntu/WSL shell):

sudo apt-get update && sudo apt-get install -y git curl
git clone https://github.com/tykimos/agent-native-agent ~/ana/base-ana
cd ~/ana/base-ana
bash skills/install/scripts/install.sh && bash skills/install/scripts/run.sh

Parameters: -Distro Ubuntu-24.04, -Repo <fork url>, -Dir ~/ana/<xxx>-ana.

WSL notes:

• Keep the repo in the Linux filesystem (~). Under /mnt/c/... file I/O is slow and check-env.sh warns about it.
• localhost not reachable from Windows → WSL1 or forwarding disabled. Check with wsl -l -v (VERSION must be 2; upgrade with wsl --set-version Ubuntu 2).
• Line endings: .gitattributes forces *.sh to LF so a Windows-side checkout doesn't break bash.

Troubleshooting

Related skills

• ana: attach the ANA runtime (channel-core.js) to an existing web app.
• cloud-setting: run ANA on a cloud VM with systemd and a Cloudflare Tunnel.