Repository navigation
Releases
Releases · fn2ai/fn2-skill
v0.5.0: one command and go
[0.5.0] - 2026-08-10
Added
fn2 linkwrites anfn2launcher into the first writablebin
directory on yourPATH, so a plugin install can actually give you the
command. The launcher re-resolves the skill at run time, so a plugin update
(which moves the versioned install directory) cannot strand it.fn2 unlink
removes it, and refuses to delete a file it did not write.- Agent references accept an id, an id prefix, or a name.
fn2 agents
prints 8-character ids; those 8 characters now work everywhere an agent is
taken. Ambiguous references are refused with the candidates listed, never
guessed. A full id still costs no extra request. --waitonstart(when it runs now) and onrun: blocks until the run
is terminal and prints the result, turning ask-and-read into one command. It
uses the API's own?wait=long-poll rather than a client-side hammer loop,
and honours--timeout(default 300s).fn2 result <agent>defaults to the newest run, so there is no run id to
copy for the common case.
Fixed
- A console that cannot encode
✓(legacy Windows cp1252) took the whole
command down withUnicodeEncodeError. Glyphs now fall back to ASCII. - API errors carrying
retry_aftersay when to try again; 5xx responses quote
theirrequest_id. - The launcher and the documented resolution chain honour
CLAUDE_CONFIG_DIR,
which a relocated Claude home needs.
v0.4.1: a plugin gives you a skill, not a binary
[0.4.1] - 2026-08-10
Fixed
- A marketplace plugin install was unreachable when the harness did not expand
${CLAUDE_SKILL_DIR}. Plugins land in
~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/skills/fn2, and
none of the fallback locations inSKILL.mdcovered it, so the helper simply
was not found. The fallback list now globs the plugin cache, newest install
first. - The README told you to run
fn2 auth loginstraight after
claude plugin install, but installing a plugin adds nothing toPATH, so
the only possible outcome wasbash: fn2: command not found. Connecting is
now something you ask the assistant to do, with a separate section for
driving the CLI yourself.make installprints the same caveat. - Both documented snippets are now executed by the test suite against all four
install layouts (plugin cache,make install, Codex, Pi), so they cannot go
stale silently.
Added
- A
fn2: command not foundentry in the troubleshooting reference.
v0.4.0: colour, FN2 AI naming, better examples
[0.4.0] - 2026-08-10
Added
- Colour in the human views: agent and run status, ids, table headers,
doctor
verdicts, and the✓confirmations. It is off unless stdout is a terminal,
NO_COLORis honoured,--jsonis never colourised, and--color auto|always|neveroverrides the lot. New modulefn2cli/style.py; column
widths are measured on visible characters, so colour never shifts a table.
Changed
- The product is written FN2 AI throughout. The
fn2command, thefn2.ai
domain, and the package name are unchanged. - Output prose no longer uses em dashes.
v0.3.0: see it in use
[0.3.0] — 2026-08-10
Changed
fn2 agentsprints market cadences in English —30m before open,
5m after close— instead of the rawmarket_open/market_close
frequency name.- Account views line up:
whoami'splan/tokens/resets/device
rows now share the 11-column label gutter used byendpoint,credential,
andauth status. fn2 modelsshowsanyfor a model with no plan lock, rather than an empty
PLANcolumn.
Added
- Documentation media in
docs/media/, generated bytools/screenshots/by
running the real CLI against fixture payloads — screenshots cannot drift from
what the tool prints. - The fn2 brand mark and lockup in
assets/. - CI across Python 3.9–3.13 plus macOS, manifest validation, issue and pull
request templates,CONTRIBUTING.md,CODE_OF_CONDUCT.md,SECURITY.md.
v0.2.0 — browser device login
Browser device authorization (fn2.ai/start) replaces API-key paste; secure OS-keychain/owner-only storage; origin-pinned; docs corrected. Requires the fn2 device-auth backend (live). See SKILL.md.