Skip to content

README.md

Latest commit

 

History

History
125 lines (85 loc) · 4.51 KB

README.md

File metadata and controls

125 lines (85 loc) · 4.51 KB

fluently-cli

Terminal CLI for Fluently — score, compare, and contribute human-AI collaboration cycles across any registered framework.

Framework-agnostic. Bundles the AI Fluency 4D Framework as the default. Works with any AI agent: Claude, GPT-4o, Gemini, Mistral, GitHub Copilot, and more.

npm version License: MIT Node ≥ 20

Install

npm install -g fluently-cli

Requires Node.js 20+.

Commands

Command What it does
fluent score <task> Find the 3 most relevant cycles from the knowledge base for a task
fluent compare --description <desc> --delegation <intent> Match a task + delegation intent to the closest cycle
fluent list [domain] Browse all cycles, optionally filtered by domain
fluent contribute Interactive wizard to build and validate a new cycle as YAML
fluent sync Pull the latest cycles from the upstream GitHub repo

Examples

Score — find similar cycles

fluent score "AI generates a first draft, human edits and publishes"
#1  AI-Assisted Technical Writing  [writing]  ██████████  82%
    delegation ████████░░  80%
    description ██████████  95%
    discernment ████████░░  80%
    diligence ██████░░░░  60%
    → knowledge/writing-ai-assisted-technical-writing.yaml

Compare — match with delegation intent

fluent compare \
  --description "AI reviews PRs for style issues, humans approve" \
  --delegation "augmented"

Delegation intent narrows the result to how much autonomy you're giving the agent:

  • automated — AI decides without human review
  • augmented — human and AI collaborate
  • supervised — human decides, AI assists

List — browse by domain

fluent list              # all cycles
fluent list coding       # coding domain only
fluent list healthcare   # healthcare domain only

Available domains: coding · writing · research · education · legal · healthcare · customer-support · general

Contribute — add a new cycle

fluent contribute

The interactive wizard walks through each dimension of the chosen framework, validates the result against the Zod schema, and writes a .yaml file ready to commit and PR to the community repo.

Sync — stay up to date

fluent sync

Pulls the latest cycles from upstream. For a global npm install, use npm update -g fluently-cli instead.

Frameworks

Fluently is framework-agnostic. Any collaboration framework with named dimensions can be registered. Each cycle carries a framework_id that determines which dimension fields it uses.

The AI Fluency 4D Framework is bundled as the default:

Dimension Question
🤝 Delegation What is delegated to AI vs. kept by humans?
📝 Description What context makes the AI most effective?
👁️ Discernment How do you evaluate and trust the AI output?
✅ Diligence What accountability steps follow AI involvement?

Additional frameworks can be added by contributing a YAML definition to /frameworks/. Cycles for that framework will be validated and scored against its own dimension schema automatically.

Browse the full community knowledge base at fluently-org.github.io/fluently/knowledge.html.

Links

License

MIT — code and bundled knowledge cycles.