CandyFiles — SugarCraft

📂 CandyFiles

Dual-pane terminal file manager

port of superfile file-manager midnight-commander dual-pane

Two panes side-by-side, Midnight Commander style. Tab to swap focus, multi-select, sort cycling, hidden-file toggle, delete-with-confirm. Pure-state transition layer — filesystem is injected, every transition is unit-testable.

Install

composer require sugarcraft/candy-files

Quickstart

composer install
./bin/candyfiles [LEFT_DIR] [RIGHT_DIR]

# Default: left = cwd, right = $HOME

# Keys
# Tab        Swap focus
# ↑ / k      Move up
# ↓ / j      Move down
# Home / g   Top
# End / G    Bottom
# Enter / →  Open directory
# ← / h      Up one directory
# Space      Toggle selection + advance
# s          Cycle sort order (6 modes)
# .          Toggle hidden files
# c          Copy selection or cursor → inactive pane (y confirm)
# m          Move selection or cursor → inactive pane (y confirm)
# R          Rename cursor entry with prompt (y confirm)
# d          Delete (selection or cursor) — y to confirm
# r          Refresh active pane
# q          Quit
# /          Search mode (type to filter, Enter to open)
# Escape     Exit search mode
# t          Duplicate current tab
# Ctrl+w     Close current tab
# Ctrl+Tab   Cycle to next tab
# u / Ctrl+z Undo last operation

What's in the box

Dual panesLeft + right; Tab swaps focus. Each pane has its own cwd, cursor, selection, sort, hidden-flag.

Multi-selectSpace toggles + advances. Selection survives sort / cwd-change.

Six sort modesname / mtime / size, asc / desc — s cycles.

Hidden-file toggle. hides / shows dotfiles.

Copy / Move / Renamec/m/R stage to inactive pane / cursor target; y commits. Undo available for move and rename.

Delete-with-confirmd stages, y commits — protects against fat-finger deletes.

Injectable FSFsLister closure — swap for a fixture lister in unit tests with no tmp dirs.

Live search/ enters search mode; type to filter, ↑↓ navigate, Enter opens.

Tab managementt duplicates tab, Ctrl+Tab cycles, Ctrl+w closes.

Undou or Ctrl+z restores last delete / move / rename.

Source & demos

Try the quickstart →

Key Classes

Class	Method	Description
Manager	start(leftCwd, rightCwd, ?lister)	Factory — initialises two panes + first tab
Manager	update(Msg): [Model, ?Cmd]	Main event loop — key dispatch, confirm gate
Manager	view(): string	Renders two panes + tab bar + status line
Manager	copy(src, dst), move(src, dst), rename(src, newName)	File-manager ops — used by confirm-gate handlers
Manager	search(query), exitSearch(), openSearchResult()	Live search mode
Manager	undo(), canUndo(), canRedo()	Delete / move / rename undo/redo stack
Manager	duplicateTab(), closeTab(), switchTab()	Tab management
Pane	open(cwd, lister, sort, showHidden): self	Factory — reads and sorts directory
Pane	navigate(lister): self	Enter directory under cursor (no-op on files)
Pane	toggleSelection(): self	Add/remove cursor entry from selection set
Sort	apply(entries): list<Entry>	Sort entries (parent sentinel stays at index 0)
Sort	cycle(): self	Cycles: name-asc → name-desc → mtime-asc → mtime-desc → size-asc → size-desc → name-asc
Entry	displaySize(): string	Returns "DIR" / "LINK" / compacted bytes

📂 CandyFiles

Install

Quickstart

What's in the box

Source & demos

Key Classes

Demos.

Navigate

Search

Multi-select

Tab management

Sort cycle

Undo delete

Hidden-file toggle