Skip to content

flow-assist 0.1.0

Latest

Choose a tag to compare

@mellonis mellonis released this 21 Sep 22:13
· 487 commits to master since this release

The first version: a terminal assistant host that knows no company and no system,
with everything specific delivered by plugins.

  • Plugins register surfaces, commands, keys, tool groups for the model, config
    schema, and the two chat hooks — what the screen is about, and a reload after a
    write. Installed from a package registry, from an archive (plugins install ./notes-0.1.0.tar.gz or its https URL — checked before it is unpacked, and never
    over a checked-out plugin), or linked from a repository of their own; a published
    plugin ships its build (files in its package.json names what goes).
    Bundled: repo (read the configured clones; branch, commit, push), gitlab
    (merge requests through glab), mcp (tools from MCP servers).
  • The chat: an LLM agent loop over an OpenAI-format API, with a y/n pause before
    every write; what a write changed stays in the chat as a diff, and is never sent
    back to the model. Streaming with a status line that says what happens now,
    a queue while an answer is written, ask_user questions, a plan (todo), memory,
    reminders, background tasks, /compact, /context, /copy, sessions that survive
    a restart (/resume), !command and shell mode, run_command behind the y/n,
    web_fetch with an allowlist and private addresses refused.
  • The screen: a start screen, a command line (:) with inline completion, help,
    the log, keycaps, mouse wheel, and drag-to-copy through the terminal's clipboard.
  • Distribution: runs with bun src/cli.ts, or as a compiled binary with built
    plugins beside it.

Files

  • flow-assist-<os>-<arch> — the host as one executable, no Bun needed:
    darwin-arm64, darwin-x64, linux-x64, linux-arm64.
  • repo-1.0.0.tar.gz, gitlab-1.0.0.tar.gz, mcp-1.0.0.tar.gz — the bundled plugins.
gh release download v0.1.0 --repo mellonis/flow-assist --pattern 'flow-assist-darwin-arm64' --pattern '*.tar.gz'
chmod +x flow-assist-darwin-arm64
./flow-assist-darwin-arm64 plugins install ./repo-1.0.0.tar.gz   # each plugin you want
./flow-assist-darwin-arm64                                        # start it

The binary keeps its plugins in plugins-available/ and plugins-enabled/ of the
directory it is started in. A macOS binary saved from a browser is quarantined:
xattr -d com.apple.quarantine flow-assist-darwin-arm64.