Instalar — Documentación de FXCode

Servicio gestionado

Regístrate y úsalo: no hay nada que instalar. Para conectar tus agentes, sigue con la CLI y el servidor MCP usando la dirección de tu cuenta.

Self-hosted

FXCode es un monorepo con la aplicación web (Next.js), el API (Express + PostgreSQL), la CLI, la app de escritorio y este sitio. Necesitas:

Node.js 20 o superior y pnpm 9
PostgreSQL 14 o superior

git clone https://github.com/fazt/fxcode.git
cd fxcode
pnpm install

Variables de entorno

El API lee apps/api/.env. Lo mínimo:

DATABASE_URL="postgresql://usuario:contraseña@localhost:5432/fxcode"
JWT_SECRET="una-cadena-larga-y-aleatoria"
PORT=4000
FRONTEND_URL="http://localhost:3000"
APP_URL="http://localhost:3000"

La aplicación lee apps/web/.env.local:

AUTH_SECRET="otra-cadena-larga-y-aleatoria"
NEXTAUTH_URL="http://localhost:3000"
NEXT_PUBLIC_API_URL="http://localhost:4000"
BACKEND_URL="http://localhost:4000"

Todo lo demás es opcional y activa funciones concretas: correo (AWS SES), almacenamiento de adjuntos (S3; sin él se guardan en disco), IA (OpenAI o Gemini), reuniones (Google Meet o Zoom) y login con GitHub.

Base de datos y primer usuario

pnpm db:push        # crea las tablas
pnpm create-admin   # el primer usuario administrador
pnpm dev            # aplicación en :3000 y API en :4000

Entra en http://localhost:3000, y en Ajustes define los estados de tus tareas: marca cuál cuenta como terminado y cuál lleva la animación de progreso (por ejemplo «Working»).

App de escritorio

La app de escritorio abre FXCode en su propia ventana, vive en la bandeja del sistema y se muestra u oculta con Ctrl + Alt + F (⌘ + ⌥ + F en Mac). Por ahora se compila desde el repositorio; necesita Rust y, en Windows, las Build Tools de Visual Studio:

pnpm build:desktop

El instalador queda en apps/desktop/src-tauri/target/release/bundle.