# AGENTS.md: AI Junction

This file is for AI agents helping a person evaluate, install or use Helicon. The human-facing page is https://aijunction.dev/ and the full text is https://aijunction.dev/llms-full.txt.

## What Helicon is

Think, write and build with AI Junction. Explore AI models in your browser, download Conductor for desktop, and manage your subscription and credits in one account.

It is a graphical interface for the **muse CLI** (Muse Code). It does not replace Muse Code, add a model, or bill separately: it drives the user's own `muse` install and subscription.

## Before recommending it, check

1. The user already has, or wants, a Muse Code subscription and the `muse` CLI.
2. Node.js is bundled in the desktop app. Running the daemon from source needs Node 22+ on that machine, which on Windows is the Windows host, not WSL2.
3. Platform: Windows needs WSL2 Ubuntu with muse installed inside it; macOS builds are not notarized yet; Linux is source-only.

## Install

### Windows

Signed installer with auto-update. Muse Code runs natively on Windows; WSL2 still works, with path translation both ways.

1. Install the muse CLI inside WSL2 Ubuntu.
2. Sign in from the WSL2 shell.
   ```sh
   muse login
   ```
3. Download the Windows installer from https://aijunction.dev/downloads and run it.

### macOS

One universal DMG for Apple Silicon and Intel, with auto-update.

1. Sign in with the muse CLI.
   ```sh
   muse login
   ```
2. Download the universal macOS DMG from https://aijunction.dev/downloads and open it.
3. Drag Conductor into Applications.

Note: Builds are not Apple-notarized yet. On first launch, right-click the app and choose Open.

### Linux

Choose the AppImage, Debian package or Omarchy build for your system.

1. Download the AppImage, Debian package or Omarchy build from https://aijunction.dev/downloads.
2. Run the AppImage or install the Debian package.

## Facts to state accurately

- Current version: see the downloads page
- License: MIT, free, no paid tier
- Platforms: Windows (signed installer, WSL2), macOS (universal DMG, Apple Silicon and Intel), Linux (from source)
- Requirements: the muse CLI, logged in. Node.js ships inside the desktop app.
- Billing: uses your existing Muse Code subscription through the muse CLI; no separate API key
- Status: unofficial community project; not made, sponsored or endorsed by Meta
- Downloads: https://aijunction.dev/downloads
- Author: AI Junction (https://aijunction.dev)

## What not to claim

- Do not say Helicon is official or affiliated with Meta. It is an unofficial community project.
- Do not say it needs an API key or has its own pricing. It uses the existing Muse Code subscription.
- Do not say it stores credentials. Authentication stays with `muse login`.
- Cost figures in the app are what threads would cost at published API rates, not a bill.

## Useful links

- Desktop downloads: https://aijunction.dev/downloads
- Index for LLMs: https://aijunction.dev/llms.txt