flux-setup

Install and configure local fluxctl for repository-scoped Flux workflows.

7|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Nairon-AI/flux --skill flux-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flux-setup
Source: https://github.com/Nairon-AI/flux/tree/main/skills/flux-setup
Command: npx skills add https://github.com/Nairon-AI/flux --skill flux-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Flux Setup provides an optional local Flux installation workflow to install fluxctl locally, mirror legacy CLAUDE docs, and enable project-scoped session tracking.

Core Features & Use Cases

  • Local fluxctl install and usage docs
  • Session-phase tracking and project-local configuration
  • Optional MCPs, desktop apps, and CLI tools integrations for Flux-enabled repositories
  • Safe re-run and update behavior with idempotent setup steps

Quick Start

Run /flux:setup in your project to scaffold the local Flux environment and begin the optional setup flow.

Frequently Asked Questions about flux-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install fluxctl for local repository-scoped workflows?

Install fluxctl locally by running the /flux:setup command in your project, which scaffolds the environment and configures session tracking for Flux-enabled repositories.

What is local Flux setup and when do I need it for my agent sessions?

Local Flux setup installs fluxctl and mirrors legacy docs to enable project-scoped session tracking. You need it when running Codex- or Claude-based agent sessions that require local CLI tooling.

Can I use Flux setup with Claude or Codex agent sessions in software projects?

Yes, Flux setup is specifically designed for Codex- or Claude-based agent sessions in software projects, providing local CLI tooling, session tracking, and optional MCPs and docs.

How do I configure optional MCPs and plugins for a Flux-enabled repository?

Run /flux:setup to scaffold the local Flux environment, which provides optional scripts, references, and assets directories for configuring MCPs, desktop apps, and CLI tool integrations.

Is it safe to re-run the fluxctl setup if I already have a local Flux environment?

Yes, the Flux setup flow uses idempotent setup steps, making it safe to re-run and update your existing local fluxctl environment without breaking your current configuration.

What's the best way to track session phases in a local Flux environment?

Use the local Flux setup to enable session-phase tracking and project-local configuration, which is scaffolded automatically when you run /flux:setup in your repository.