Skip to content

installation-guide.md

Latest commit

 

History

History
136 lines (97 loc) · 4.01 KB

installation-guide.md

File metadata and controls

136 lines (97 loc) · 4.01 KB

Installation Guide (Current)

Verified Web Install (Copy/Paste)

Bootstrap downloads the latest signed source artifact (ica-<tag>-source.tar.gz) from the latest release and verifies it against SHA256SUMS.txt.

Release assets: https://github.com/intelligentcode-ai/intelligent-code-agents/releases/latest

macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/intelligentcode-ai/intelligent-code-agents/main/scripts/bootstrap/install.sh | bash

Windows PowerShell:

iwr https://raw.githubusercontent.com/intelligentcode-ai/intelligent-code-agents/main/scripts/bootstrap/install.ps1 -UseBasicParsing | iex

Then run:

ica install
ica serve --open=true

Bootstrap validates release artifacts and stops on verification failures. It does not auto-run install/sync.

Build From Source

npm ci
npm run build

CLI Installer (ica)

Commands:

node dist/src/installer-cli/index.js install
node dist/src/installer-cli/index.js uninstall
node dist/src/installer-cli/index.js sync
node dist/src/installer-cli/index.js list
node dist/src/installer-cli/index.js doctor
node dist/src/installer-cli/index.js catalog
node dist/src/installer-cli/index.js serve --open=true
node dist/src/installer-cli/index.js sources list
node dist/src/installer-cli/index.js sources add --repo-url=https://github.com/intelligentcode-ai/skills.git
node dist/src/installer-cli/index.js sources add --repo-path=.   # uses current directory as local source
node dist/src/installer-cli/index.js sources update --id=my-source --publish-default-mode=branch-pr --default-base-branch=main --provider-hint=github
node dist/src/installer-cli/index.js sources refresh
node dist/src/installer-cli/index.js skills validate --path=/path/to/skill --profile=personal
node dist/src/installer-cli/index.js skills publish --source=my-source --path=/path/to/skill
node dist/src/installer-cli/index.js skills contribute-official --path=/path/to/skill

Skill Publishing Quick Start

  1. Add or update a source:
node dist/src/installer-cli/index.js sources add --repo-url=https://github.com/your-org/skills.git --name=my-source
node dist/src/installer-cli/index.js sources update --id=my-source \
  --publish-default-mode=branch-pr \
  --default-base-branch=main \
  --provider-hint=github \
  --official-contribution-enabled=false
  1. Validate and publish:
node dist/src/installer-cli/index.js skills validate --path=/path/to/skill --profile=personal
node dist/src/installer-cli/index.js skills publish --source=my-source --path=/path/to/skill
  1. Propose to official source:
node dist/src/installer-cli/index.js skills validate --path=/path/to/skill --profile=official
node dist/src/installer-cli/index.js skills contribute-official --path=/path/to/skill

Non-interactive example:

node dist/src/installer-cli/index.js install --yes \
  --targets=claude,codex \
  --scope=project \
  --project-path=/path/to/project \
  --mode=symlink \
  --skills=developer,architect,reviewer \
  --remove-unselected

Dashboard (Local-first)

Recommended after bootstrap:

ica serve --open=true
  • Default bind: 127.0.0.1
  • Default URL: http://127.0.0.1:4173
  • API URL: http://127.0.0.1:4174 (secured with per-session X-ICA-API-Key)
  • Browser traffic uses same-origin dashboard routes (/api/v1/*, /ws/events) via the host BFF proxy.

Scope

  • User scope: ~/.claude, ~/.codex, ~/.cursor, ~/.gemini, ~/.antigravity
  • Project scope: <project>/.claude, <project>/.codex, ...

CLI default: for --scope=project, if --project-path is omitted, ICA uses the current working directory.

Install Mode

  • symlink (default)
  • copy

If symlink fails, ICA falls back to copy and records the effective mode.

Managed State

  • <agent-home>/.ica/install-state.json

Used for safe uninstall and sync of managed assets only.

Legacy Deployment Paths Removed

This repository no longer supports:

  • Make-based deployment
  • Ansible deployment
  • old root PowerShell deployment wrapper (install.ps1)