Skip to content

Workflow integrations: evaluate Atuin, fzf/Television, Pueue, Yazi, delta/bat and zoxide #366

Open
Open
Workflow integrations: evaluate Atuin, fzf/Television, Pueue, Yazi, delta/bat and zoxide#366
Labels
area:executionCommand execution and lifecycletype:featureNew feature or improvement

Description

@raiseCatError
raiseCatError
opened on Oct 10, 2026

Goal

Give the #359 terminal workflow initiative a single decision-and-integration tracker for tools that genuinely improve copying, searching, previewing and reusing command results.

Audit first

NMSh already supports some of Atuin, fzf/Television, zoxide, bat, delta, and other curated tools/providers. Read current /tools, /providers, /watch, /open, Theme Bridge, clipboard and command queue integration before proposing anything. Separate existing support from planned features.

Candidate Question to answer
Atuin Does project/session-aware history enrich existing native search without stealing shell-history authority?
fzf / Television Can providers power consistent preview/select actions without inventing another picker subsystem?
Pueue Where is durable detached background processing genuinely useful? Never replace NMSh's native same-shell queue with independent child processes.
Yazi Can a supported file-selection handoff return paths to the composer safely, without a second file manager?
delta / bat When do diff/source previews gain something over native Compare and existing supported rendering?
zoxide Does integration improve directory routing beyond existing /dirs?
Gum Preserve terminal input ownership and external interactive prompt interoperability; do not imitate a second forms framework.

Defaults and safety

Every integration is optional, absent-dependency-safe, user-controlled and truthfully described. Never auto-install, mutate external configs, run AI/clipboard-sourced commands, or transmit clipboard contents. Reuse host/shell capability detection, ScreenPlan and the existing provider registry. Keep PTY/passthrough and password/single-key input semantics correct.

Acceptance

  • Document baseline support and per-candidate use case, dependency, risk and decision (adopt / defer / reject) with links.
  • Implement only high-return integrations in focused PRs, with honest fallback and confirmation.
  • Real-shell/PTY and narrow/NO_COLOR/Safe tests for adopted slices.
  • Document explicitly why native queue, native Compare and existing tools are retained.

Related: #359, #304 Theme Bridge, #305 Context Engine; no wholesale terminal/multiplexer replacement.

Activity

  1. raiseCatError
    added
    area:executionCommand execution and lifecycle
    type:featureNew feature or improvement
    on Oct 10, 2026
  2. raiseCatError
    added a commit that references this issue on Oct 10, 2026

    Docs: external tool decisions for #366

    b08d235

  3. raiseCatError commented on Oct 11, 2026

    @raiseCatError
    raiseCatError
    on Oct 11, 2026
    OwnerAuthor

    Code audit and decisions are recorded in docs/design/external-tool-decisions.md on local additive #368 candidate 5e45e87.

    Adopt the existing optional Atuin history source, fzf/Television picker providers, zoxide directory routing through a private bounded database copy, and bat/delta Theme Bridge slices. Their registries, runtime adapters and absent-dependency fallbacks were inspected; no new external adapter is claimed.

    Retain the native sequential same-shell queue and stored-output Compare. Pueue background handoff is deferred until durable output-capture semantics are designed; it cannot replace this queue. Yazi chooser handoff is deferred pending a bounded path-return contract. Reject an embedded Gum forms adapter; ordinary external interactive passthrough remains supported, with real Gum physical interoperability unvalidated.

    The audit preserves deliberate deferrals and avoids duplicate picker/file-manager/theme engines. Provider availability tests now supply a fixture installer instead of assuming host Homebrew; product installation remains optional, explicitly confirmed and restricted to verified typed argv.

    Existing provider/bridge tests and real-PTY queue, fullscreen ownership and report/diff regressions cover the retained paths. Final cross-feature canonical/Actions are running. Host-specific picker visuals and physical terminal behavior remain human QA. No automatic install, clipboard transmission or external-config mutation was introduced.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:executionCommand execution and lifecycletype:featureNew feature or improvement

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions