Repository navigation
DashFloat 0.3.0
mise ~/.config/mise/config.toml tools: gh@2.103.2 DashFloat 0.3.0.
What's new in 0.3.0
Nine features since 0.2.0:
- Sessions have titles. Name a session as you start it with
dashfloat --title "My session", and pick it back up later withdashfloat --resume <id-or-title>— every session is identified by a time-sorting UUID id. Leave the title off and the model proposes one once the conversation is underway;/titlerenames at runtime. Titles are unique, so a title resolves to one session. - A wizard that knows your models. First-run setup now fetches the provider's model list and offers it as a keyboard-navigable picker; manual entry is the explicit last option, and a failed fetch falls back to it with the reason on screen. ESC returns to the previous step with your answers preserved.
- Slash commands and a palette.
/model,/profile,/mode, and/titleswitch at runtime. Typing/lists every command, autocomplete narrows as you type, and Ctrl+P opens the same list as a palette. - A system prompt with your project's instructions. Every session now runs on an assembled system prompt, and DashFloat discovers
AGENTS.mdfiles — from the working directory up to the git root (or the filesystem root outside a repo) — and includes them, most general first. - Tool-call repair and web search. When the model emits a malformed tool call, DashFloat routes it through Synthetic's fix-json repair instead of failing the call, and a
web_searchtool joins the toolbox — both need a Synthetic key in your configuration. - A composer that reads alive. The idle cursor renders bright on every terminal palette, and the placeholder hint shows only before your first exchange.
- Manual compaction.
/compactruns the same drop-oldest compaction the ~80% threshold triggers, on demand and with visible feedback; at or under the trigger it reports where the context stands instead of compacting. - Live context stats. The footer shows tokens used and the percent of the context window, kept current as turns complete (the percent appears once a context window is known for the model —
contextin settings,DASHFLOAT_CONTEXT_TOKENS, or the provider's fetched model list). - Image attachments. Ctrl+O opens the attach prompt: type an image's path (PNG, JPEG, GIF, or WebP, up to 10 MiB — validated before it sits in the composer). The attach goes through when the selected model can take images; otherwise it is refused with a visible message, never silently dropped.
Upgrading: re-run the install command below — it replaces the previous version and keeps your sessions. On macOS, brew upgrade dashfloat does the same once the tap catches up with the release.
Install
curl -fsSL https://github.com/fluxvale/dashfloat/releases/latest/download/install.sh | shInstalls into ~/.local/share/dashfloat, puts a shim in ~/.local/bin, verifies the sha256 before extracting, and prunes the previous version on upgrade. Pin this version with DASHFLOAT_VERSION=0.3.0.
macOS with Homebrew:
brew install fluxvale/tap/dashfloatmacOS: first launch of an unsigned build
These binaries are not notarized. A copy downloaded with a browser carries the quarantine flag and macOS refuses it with "unidentified developer". Clear it once, either way:
- Finder: right-click (or Control-click)
dashfloat, choose Open, then Open again in the dialog. - Terminal:
xattr -d com.apple.quarantine "$(command -v dashfloat)".
Installing with curl or Homebrew sets no quarantine flag, so there is nothing to clear. Notarization is not part of 0.3.0.
Linux requirements
Built on Debian 12 and needs glibc 2.34+, so it runs on Debian 12+, Ubuntu 22.04+, and current Fedora/RHEL; Debian 11 does not. It links the system libtinfo.so.6, libstdc++.so.6, and OpenSSL 3 (libcrypto.so.3); those are present on the distributions above but not necessarily in a minimal container — the installer checks first and names the package. Debian 11 and Alpine/musl are not supported, nor is Linux arm64.
Bundled SCTP library (Linux)
The Linux tarball bundles an unmodified libsctp.so.1 from Debian 12's libsctp1 package (lksctp-tools), redistributed under the LGPL-2.1-or-later. Corresponding source is available upstream and as the Debian lksctp-tools source package; the full licence text and a redistribution notice travel inside the tarball (lib/sctp/), where the library sits as a separate, replaceable file.
Verify
curl -fsSLO https://github.com/fluxvale/dashfloat/releases/download/v0.3.0/dashfloat-0.3.0-sha256sums.txt
sha256sum -c dashfloat-0.3.0-sha256sums.txt # macOS: shasum -a 256 -cWindows is not supported in 0.3.0.