How alikarpykov/fs-linker works
FS-Linker is an interactive terminal tool for moving selected files or directories while preserving their original paths as symbolic links. The principal workflow is to browse source and target panels, select entries, preview an audited Link Plan, then execute safe links or migrations; unlinking removes selected source symlinks without touching target data. The graph separates browsing, workspace interaction, planning/audit, and filesystem operations. Relationships reflect the excerpts, SOURCE INDEX references, and README; unsampled implementation details are not inferred.
Main entry points: useLinkingWorkspace.ts Workspace State · LinkingWorkspace.tsx Workspace UI · usePanel.ts Panel State · fileSystemEntry.ts Directory Entries
Components 21
File Browsing
- Panel Views
src/widgets/linking-workspace/ui/Panel.tsx - Panel State
src/widgets/linking-workspace/model/usePanel.ts - Directory Watch
src/widgets/linking-workspace/model/useWatchDirectory.ts - Directory Entries
src/entities/file-system-entry/api/fileSystemEntry.ts - Entry Model
src/entities/file-system-entry/model/entry.ts
Terminal Workspace
- CLI Entry
src/app/cli.ts - App Commands
src/app/commands/index.tsx - Workspace UI
src/widgets/linking-workspace/ui/LinkingWorkspace.tsx - Keyboard Controls
src/widgets/linking-workspace/model/useLinkingKeyboard.ts - Workspace State
src/widgets/linking-workspace/model/useLinkingWorkspace.ts
Planning And Audit
- Plan State
src/widgets/linking-workspace/model/useLinkPlan.ts - Plan Navigation
src/widgets/linking-workspace/model/useLinkPlanNavigation.ts - Plan View
src/widgets/linking-workspace/ui/LinkPlan.tsx - Plan Builder
src/entities/link/model/getLinkPlanEntries.ts - Entry Audit Loop
src/entities/link/model/forEachLinkEntry.ts - Safety Audit
src/entities/link/model/audit.ts
Link Operations
- Link Execution
src/entities/link/model/linkEntries.ts - Filesystem Linker
src/entities/link/model/linker.ts - Unlink Operation
src/entities/link/model/unlinkEntries.ts
Other components
- Developer
- Local Filesystem
Connections 23
- Developer → CLI Entry: launches
README.md - App Commands → Workspace UI: renders
src/app/commands/index.tsx - Workspace UI → Workspace State: uses state
src/widgets/linking-workspace/ui/LinkingWorkspace.tsx - Workspace UI → Keyboard Controls: registers controls
src/widgets/linking-workspace/ui/LinkingWorkspace.tsx - Workspace UI → Panel Views: renders panels
- Workspace State → Panel State: creates panels
src/widgets/linking-workspace/model/useLinkingWorkspace.ts - Workspace State → Plan State: builds plan state
src/widgets/linking-workspace/model/useLinkingWorkspace.ts - Workspace State → Plan Navigation: tracks plan focus
src/widgets/linking-workspace/model/useLinkingWorkspace.ts - Panel State → Directory Entries: loads entries
src/widgets/linking-workspace/model/usePanel.ts - Panel State → Directory Watch: watches directory
src/widgets/linking-workspace/model/usePanel.ts - Directory Entries → Entry Model: uses entry model
src/entities/file-system-entry/api/fileSystemEntry.ts - Directory Entries → Local Filesystem: reads entries
src/entities/file-system-entry/api/fileSystemEntry.ts - Plan State → Plan Builder: requests plan
src/widgets/linking-workspace/model/useLinkPlan.ts - Plan View → Plan Builder: reads plan entries
src/widgets/linking-workspace/ui/LinkPlan.tsx - Plan Builder → Entry Audit Loop: iterates sources
src/entities/link/model/getLinkPlanEntries.ts - Entry Audit Loop → Safety Audit: audits paths
src/entities/link/model/forEachLinkEntry.ts - Safety Audit → Local Filesystem: inspects paths
src/entities/link/model/audit.ts - Workspace State → Link Execution: executes selections
src/widgets/linking-workspace/model/useLinkingWorkspace.ts - Workspace State → Unlink Operation: unlinks selections
src/widgets/linking-workspace/model/useLinkingWorkspace.ts - Link Execution → Entry Audit Loop: processes entries
src/entities/link/model/linkEntries.ts - Link Execution → Filesystem Linker: delegates operations
src/entities/link/model/linkEntries.ts - Filesystem Linker → Local Filesystem: moves and links
- Unlink Operation → Local Filesystem: removes symlinks