Install Alfred

One curl opens an app-like, human-first installer. Use arrow keys, checkbox-style toggles, text inputs, and mouse clicks where supported. Harness choices show installed/not-installed status and support selecting multiple targets before Alfred writes anything.

Requirements

• Node.js 22+ (node -v)
• pnpm 10+ (optional) — only for monorepo development
• One of: opencode, Pi, Codex, Claude, VSCode
• macOS, Linux, or WSL2

Choose an edition

For human installs, start with the guided flow: curl -fsSL https://raw.githubusercontent.com/GOI17/main/install.sh | sh. The installer still accepts flags for automation and CI.

Option A — coding edition

The fastest path. Perfect for coding harness operations without forcing Memory setup.

# Guided human-first install; starts preview-first
curl -fsSL https://raw.githubusercontent.com/GOI17/main/install.sh | sh

# Force the dependency-free compatibility backend for diagnostics
curl -fsSL https://raw.githubusercontent.com/GOI17/main/install.sh | ALFRED_INSTALL_TUI_BACKEND=node sh

# Automation fallback when choices are already known
curl -fsSL https://raw.githubusercontent.com/GOI17/main/install.sh | sh -s -- --edition=coding --name=acme --harness=opencode,codex-cli --apply

# The TUI previews runtime profiles before activation
Profile strategy: runtime profiles / decide later
Active profile : work / personal / custom
Harness        : opencode

# The installer prints the validation plan for the selected edition
Validation     local capability checks · preview files · approval gates

The coding edition includes packages/profile-manager so the same agent can have separate work, personal, or client profiles across machines without hand-editing harness config.

Model assignment during install

The installer detects available providers and local models without calling a provider, then previews smart defaults for *, orchestrator, developer, and temporary. It writes ~/.alfred/models.json only when you explicitly accept the model defaults or apply the plan.

# Smart model defaults are previewed first
Target path : ~/.alfred/models.json
Wildcard   : ollama/qwen2.5-coder:7b
Developer  : anthropic/claude-sonnet-4
Fallbacks  : global chain, ordered local → cheap cloud → premium cloud

Write model defaults? [y/N]

Option B — Memory edition

Use Alfred Memory from ChatGPT, Claude, Gemini, or coding agents.

1. Create a free Postgres database (Neon / Supabase / Render).
2. Copy the connection string — it looks like postgres://user:pass@host/db?sslmode=require.
3. Run the guided installer and choose the Memory edition. Pick Postgres for shared/human/web memory, or decide later for a first preview.

# Guided install: choose Memory or full in the TUI
curl -fsSL https://raw.githubusercontent.com/GOI17/main/install.sh | sh

Approve, then write

Alfred never writes harness config without your approval. When the installer finishes detection, it prints a preview like:

# Alfred install preview
Harness detected : opencode
Adapter status   : executable-translation-spike
Files to write   : 7
  + .opencode/agents/orchestrator.md
  + .opencode/agents/developer.md
  + .opencode/agents/qa.md
  + .opencode/skills/architecture-docs/SKILL.md
  + .opencode/skills/typescript-project/SKILL.md
  + opencode.json
  + AGENTS.md (merge)

Apply changes? [y/N]

Review the list first. The root installer writes no files unless you choose apply in the TUI or pass --apply in automation; harness config still remains preview-only until a human explicitly copies or applies those generated artifacts.

Verify the install

Use local checks instead of assuming a global CLI binary exists:

node -v                     # Node 22+
test -f ~/.alfred/models.json # if model defaults were applied
test -d ~/.alfred/installs/default # default suite install target

Uninstall

curl -fsSL https://raw.githubusercontent.com/GOI17/main/uninstall.sh | sh

The uninstaller removes the installed package tree, never touches your project files, and asks before deleting the SQLite database.