Flonat Research

flonat-research: a dual-client research framework
Repository transition complete: this project moved from the Claude-only
claude-research name to the client-neutral flonat-research framework for
both Claude Code and Codex. Existing checkouts remain supported during the
migration; use the transition guide
to replace legacy home-directory links safely and verify the new managed-copy
installation before removing any backup.

A client-neutral research infrastructure with skills, agents, rules,
files-first context, and optional Claude hooks. It is
built for researchers who write papers in LaTeX, manage bibliographies, run
experiments, and want AI assistance that understands academic conventions.

Works on macOS, Linux, and Windows with Claude Code, Codex, or both. Both
clients read the same project files; adapters expose only the skills and agents
their client can execute accurately.

This public repository and flonat-research-friends are alternative managed
distributions, not layers to install on top of each other. Both own overlapping
paths under ~/.claude/, ~/.agents/, and ~/.codex/; choose one checkout as
the installer source on a machine. The private Task Management control plane is
a separate upstream and is not required for the public installation.

See Building a Client-Neutral AI Control Plane
for the architecture, trade-offs, staged adoption process, and implementation
checklist behind the dual-client design.

The generated AI surface availability table shows
exactly which skills, agents, rules, hooks, MCP registrations, and CLIs are
available to each client and why an exclusion exists.

Installation

Install with npm

Use --client claude or --client codex for a single-client installation.

Install from the repository

Alternatively, clone the repository and run…