Skip to content

Product Capability Matrix

This document is automatically generated from src/file_organizer/core/capability_registry.json. It provides an authoritative, evidence-backed matrix of product capabilities across all official surfaces.

Status Dimensions

  • Target Support: Intended product support level (Full, Read-only, Redirect/deep-link, N/A).
  • Implementation Status: Current implementation state (Implemented, Partial, Not-implemented, N/A).
  • Conformance Status: Executable parity evidence state (Verified, Unverified, N/A).

[!IMPORTANT] A surface cell formatted as Full (Implemented / Unverified) represents an implemented feature that lacks full executable conformance evidence. Target support is never equated with verified shipped status.

Summary Statistics

Total Capabilities: 34

Surface Target Full/Read-Only Implemented Conformance Verified
CLI 30 30 3
REST API 29 23 3
Python SDK 29 23 3
TypeScript SDK 29 23 3
Web / Desktop 28 22 3
TUI 23 18 2

Cross-Surface Overview Matrix

Capability ID Name Maturity CLI REST API Python SDK TypeScript SDK Web / Desktop TUI
accounts.manage Account and workspace management Beta N/A Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Implemented / Unverified) N/A
analysis.inspect AI-assisted file analysis Beta Full (Implemented / Unverified) Full (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Partial / Unverified) Full (Partial / Unverified)
analytics.inspect Organization analytics Beta Read-only (Implemented / Unverified) Read-only (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Read-only (Implemented / Unverified) Read-only (Implemented / Unverified)
api-keys.manage API key management Beta Full (Partial / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Implemented / Unverified) N/A
audio.transcribe Audio transcription Beta Full (Implemented / Unverified) Full (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Not-implemented / Unverified) Full (Implemented / Unverified)
authentication.manage User authentication Stable Full (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) N/A
automation.rules Organization rules Beta Full (Implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified)
automation.suggestions Smart suggestions Beta Full (Implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified)
automation.tags Automatic tagging Beta Full (Implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified)
automation.watcher Background watcher Stable Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Partial / Unverified) Full (Not-implemented / Unverified)
configuration.manage Configuration management Stable Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Partial / Unverified)
configuration.profiles Named configuration profiles Beta Full (Partial / Unverified) N/A N/A N/A N/A N/A
copilot.chat Copilot chat Experimental Full (Implemented / Unverified) N/A N/A N/A N/A Full (Implemented / Unverified)
deduplication.manage Duplicate management Stable Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified)
files.browse File browsing Stable Read-only (Implemented / Unverified) Read-only (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Read-only (Implemented / Unverified) Read-only (Implemented / Unverified)
files.inspect File inspection Stable Read-only (Implemented / Unverified) Read-only (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Read-only (Implemented / Unverified) Read-only (Implemented / Unverified)
files.mutate Direct file mutations Beta N/A Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Partial / Unverified) N/A
history.manage Operation history and undo Stable Full (Implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified) Full (Partial / Unverified) Full (Partial / Unverified)
integrations.manage External integrations Experimental N/A Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) N/A N/A
interfaces.launch Interactive interface launchers Stable Full (Implemented / Unverified) N/A N/A N/A N/A N/A
marketplace.manage Plugin marketplace Beta Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) N/A
methodology.configure Organization methodology Beta Full (Implemented / Verified) Full (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Partial / Unverified) Full (Implemented / Unverified)
models.manage AI model management Beta Full (Implemented / Unverified) N/A N/A N/A Full (Implemented / Unverified) Full (Partial / Unverified)
organization.execute Organization execution Stable Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified)
organization.jobs-recovery Organization jobs and recovery Beta Full (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Partial / Unverified)
organization.preview Organization preview Stable Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified)
organization.scan Organization scan Stable Full (Partial / Unverified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Implemented / Verified) Full (Partial / Unverified)
organization.suggest Single-file organization suggestion Stable Full (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Not-implemented / Unverified) Full (Not-implemented / Unverified)
plugins.runtime Plugin runtime API Experimental N/A Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) N/A N/A
search.query File search Stable Read-only (Implemented / Unverified) Read-only (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Read-only (Partial / Unverified) Read-only (Partial / Unverified)
setup.configure Initial setup Stable Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified)
system.inspect System health and status Stable Read-only (Implemented / Unverified) Read-only (Implemented / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Read-only (Partial / Unverified) Read-only (Partial / Unverified)
updates.manage Application updates Stable Full (Implemented / Unverified) N/A N/A N/A N/A Redirect/deep-link (Partial / Unverified)
video.analyze Video analysis Beta Full (Partial / Unverified) Full (Partial / Unverified) Full (Implemented / Unverified) Full (Implemented / Unverified) Read-only (Partial / Unverified) N/A

Detailed Capability Breakdown

accounts.manage — Account and workspace management

Description: Manage account details, security, activity, teams, sharing, notifications, and workspaces.

  • Maturity: Beta
  • Execution Scopes: remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Not-applicable Not-applicable Not-applicable None
REST API Full Not-implemented Unverified None
Python SDK Full Not-implemented Unverified None
TypeScript SDK Full Not-implemented Unverified None
Web / Desktop Full Implemented Unverified GET /ui/profile, GET /ui/profile/account-settings, POST /ui/profile/account-settings/2fa, POST /ui/profile/account-settings/password, GET /ui/profile/activity, GET /ui/profile/avatar/{user_id}, GET /ui/profile/edit, POST /ui/profile/edit, POST /ui/profile/edit-avatar, GET /ui/profile/forgot-password, POST /ui/profile/forgot-password, GET /ui/profile/team, POST /ui/profile/team/invite, POST /ui/profile/team/role, GET /ui/profile/shared, POST /ui/profile/shared/add, POST /ui/profile/shared/remove, GET /ui/profile/notifications, POST /ui/profile/notifications/mark-read, GET /ui/profile/workspaces, POST /ui/profile/workspaces/create, POST /ui/profile/workspaces/switch
TUI Not-applicable Not-applicable Not-applicable None

analysis.inspect — AI-assisted file analysis

Description: Analyze file content and metadata, including optional vision, audio, and video features.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: parsers, audio, video, cloud, claude, llama, mlx

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo analyze, fo organize, fo organize --transcribe-audio
REST API Full Partial Unverified POST /api/v1/analyze
Python SDK Full Implemented Unverified FileOrganizerClient.analyze, AsyncFileOrganizerClient.analyze
TypeScript SDK Full Implemented Unverified FileOrganizerClient.analyze
Web / Desktop Full Partial Unverified GET /ui/files/preview, POST /ui/settings/models/test
TUI Full Partial Unverified AudioView, FilePreviewView

analytics.inspect — Organization analytics

Description: Inspect organization activity, storage metrics, trends, and exported reports.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Read-only Implemented Unverified fo analytics
REST API Read-only Partial Unverified GET /api/v1/system/stats
Python SDK Full Implemented Unverified FileOrganizerClient.system_stats, AsyncFileOrganizerClient.system_stats
TypeScript SDK Full Implemented Unverified FileOrganizerClient.systemStats
Web / Desktop Read-only Implemented Unverified GET /ui/organize/stats, GET /ui/organize/stats/events, GET /ui/organize/report/{job_id}
TUI Read-only Implemented Unverified AnalyticsView

api-keys.manage — API key management

Description: Generate, list, and revoke credentials used for authenticated API access.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Partial Unverified fo api-keys generate
REST API Full Not-implemented Unverified None
Python SDK Full Not-implemented Unverified None
TypeScript SDK Full Not-implemented Unverified None
Web / Desktop Full Implemented Unverified GET /ui/profile/api-keys, POST /ui/profile/api-keys/generate, POST /ui/profile/api-keys/revoke
TUI Not-applicable Not-applicable Not-applicable None

audio.transcribe — Audio transcription

Description: Transcribe supported local audio content for analysis and organization.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: audio

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo organize --transcribe-audio
REST API Full Partial Unverified POST /api/v1/analyze
Python SDK Full Implemented Unverified FileOrganizerClient.analyze, AsyncFileOrganizerClient.analyze
TypeScript SDK Full Implemented Unverified FileOrganizerClient.analyze
Web / Desktop Full Not-implemented Unverified None
TUI Full Implemented Unverified AudioView

authentication.manage — User authentication

Description: Register, sign in, refresh identity, inspect the current user, and sign out.

  • Maturity: Stable
  • Execution Scopes: remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Partial Unverified fo api login, fo api me, fo api logout
REST API Full Implemented Unverified POST /api/v1/auth/register, POST /api/v1/auth/login, POST /api/v1/auth/refresh, GET /api/v1/auth/me, POST /api/v1/auth/logout
Python SDK Full Implemented Unverified FileOrganizerClient.register, AsyncFileOrganizerClient.register, FileOrganizerClient.login, AsyncFileOrganizerClient.login, FileOrganizerClient.refresh_token, AsyncFileOrganizerClient.refresh_token, FileOrganizerClient.logout, AsyncFileOrganizerClient.logout, FileOrganizerClient.me, AsyncFileOrganizerClient.me
TypeScript SDK Full Implemented Unverified FileOrganizerClient.register, FileOrganizerClient.login, FileOrganizerClient.refreshToken, FileOrganizerClient.logout, FileOrganizerClient.me
Web / Desktop Full Implemented Unverified GET /ui/profile/register, POST /ui/profile/register, GET /ui/profile/login, POST /ui/profile/login, POST /ui/profile/logout, GET /ui/profile/reset-password, POST /ui/profile/reset-password
TUI Not-applicable Not-applicable Not-applicable None

automation.rules — Organization rules

Description: Create, preview, apply, import, export, and watch declarative organization rules.

  • Maturity: Beta
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo rules list, fo rules sets, fo rules add, fo rules remove, fo rules toggle, fo rules preview, fo rules apply, fo rules watch, fo rules export, fo rules import
REST API Full Not-implemented Unverified None
Python SDK Full Not-implemented Unverified None
TypeScript SDK Full Not-implemented Unverified None
Web / Desktop Full Not-implemented Unverified None
TUI Full Not-implemented Unverified None

automation.suggestions — Smart suggestions

Description: Generate, inspect, and apply learned file-placement suggestions.

  • Maturity: Beta
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo suggest files, fo suggest patterns, fo suggest apply
REST API Full Not-implemented Unverified None
Python SDK Full Not-implemented Unverified None
TypeScript SDK Full Not-implemented Unverified None
Web / Desktop Full Not-implemented Unverified None
TUI Full Not-implemented Unverified None

automation.tags — Automatic tagging

Description: Suggest, apply, inspect, and batch-manage file tags.

  • Maturity: Beta
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo autotag suggest, fo autotag apply, fo autotag popular, fo autotag batch, fo autotag recent
REST API Full Not-implemented Unverified None
Python SDK Full Not-implemented Unverified None
TypeScript SDK Full Not-implemented Unverified None
Web / Desktop Full Not-implemented Unverified None
TUI Full Not-implemented Unverified None

automation.watcher — Background watcher

Description: Start, stop, inspect, and configure continuous directory watching.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo daemon start, fo daemon stop, fo daemon status, fo daemon watch, fo daemon process
REST API Full Implemented Unverified POST /api/v1/daemon/start, POST /api/v1/daemon/stop, POST /api/v1/daemon/toggle, GET /api/v1/daemon/status
Python SDK Full Implemented Unverified FileOrganizerClient.toggle_daemon, AsyncFileOrganizerClient.toggle_daemon, FileOrganizerClient.start_daemon, AsyncFileOrganizerClient.start_daemon, FileOrganizerClient.stop_daemon, AsyncFileOrganizerClient.stop_daemon, FileOrganizerClient.daemon_status, AsyncFileOrganizerClient.daemon_status
TypeScript SDK Full Implemented Unverified FileOrganizerClient.toggleDaemon, FileOrganizerClient.startDaemon, FileOrganizerClient.stopDaemon, FileOrganizerClient.daemonStatus
Web / Desktop Full Partial Unverified GET /ui/settings/advanced, POST /ui/settings/advanced
TUI Full Not-implemented Unverified None

configuration.manage — Configuration management

Description: Read, validate, update, import, export, and reset application configuration.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo config show, fo config list, fo config edit
REST API Full Implemented Unverified GET /api/v1/config, PUT /api/v1/config, POST /api/v1/config/reset, GET /api/v1/system/config, PATCH /api/v1/system/config
Python SDK Full Implemented Unverified FileOrganizerClient.get_application_config, AsyncFileOrganizerClient.get_application_config, FileOrganizerClient.update_application_config, AsyncFileOrganizerClient.update_application_config, FileOrganizerClient.reset_application_config, AsyncFileOrganizerClient.reset_application_config, FileOrganizerClient.get_config, AsyncFileOrganizerClient.get_config, FileOrganizerClient.update_config, AsyncFileOrganizerClient.update_config
TypeScript SDK Full Implemented Unverified FileOrganizerClient.getApplicationConfig, FileOrganizerClient.updateApplicationConfig, FileOrganizerClient.resetApplicationConfig, FileOrganizerClient.getConfig, FileOrganizerClient.updateConfig
Web / Desktop Full Implemented Unverified GET /ui/settings, GET /ui/settings/general, POST /ui/settings/general, GET /ui/settings/appearance, POST /ui/settings/appearance, GET /ui/settings/export, POST /ui/settings/import, POST /ui/settings/reset
TUI Full Partial Unverified SettingsView

configuration.profiles — Named configuration profiles

Description: Create, activate, merge, migrate, validate, import, and export named local profiles.

  • Maturity: Beta
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Partial Unverified fo profile
REST API Not-applicable Not-applicable Not-applicable None
Python SDK Not-applicable Not-applicable Not-applicable None
TypeScript SDK Not-applicable Not-applicable Not-applicable None
Web / Desktop Not-applicable Not-applicable Not-applicable None
TUI Not-applicable Not-applicable Not-applicable None

copilot.chat — Copilot chat

Description: Interpret natural-language file-management requests and propose explicit actions.

  • Maturity: Experimental
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: cloud, claude, llama, mlx

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo copilot chat, fo copilot status
REST API Not-applicable Not-applicable Not-applicable None
Python SDK Not-applicable Not-applicable Not-applicable None
TypeScript SDK Not-applicable Not-applicable Not-applicable None
Web / Desktop Not-applicable Not-applicable Not-applicable None
TUI Full Implemented Unverified CopilotView

deduplication.manage — Duplicate management

Description: Scan, preview, report, and resolve duplicate file groups.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: dedup

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo dedupe scan, fo dedupe report, fo dedupe resolve
REST API Full Implemented Unverified POST /api/v1/dedupe/scan, POST /api/v1/dedupe/preview, POST /api/v1/dedupe/execute
Python SDK Full Implemented Unverified FileOrganizerClient.dedupe_scan, AsyncFileOrganizerClient.dedupe_scan, FileOrganizerClient.dedupe_preview, AsyncFileOrganizerClient.dedupe_preview, FileOrganizerClient.dedupe_execute, AsyncFileOrganizerClient.dedupe_execute
TypeScript SDK Full Implemented Unverified FileOrganizerClient.dedupeScan, FileOrganizerClient.dedupePreview, FileOrganizerClient.dedupeExecute
Web / Desktop Full Not-implemented Unverified None
TUI Full Not-implemented Unverified None

files.browse — File browsing

Description: Browse directory contents with filtering, sorting, pagination, and hidden-file policy.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Read-only Implemented Unverified fo api files
REST API Read-only Implemented Unverified GET /api/v1/files
Python SDK Full Implemented Unverified FileOrganizerClient.list_files, AsyncFileOrganizerClient.list_files
TypeScript SDK Full Implemented Unverified FileOrganizerClient.listFiles
Web / Desktop Read-only Implemented Unverified GET /ui/files, GET /ui/files/list, GET /ui/files/tree
TUI Read-only Implemented Unverified FileBrowserView

files.inspect — File inspection

Description: Read file metadata, supported content, previews, thumbnails, and downloads.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: parsers, audio, video

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Read-only Implemented Unverified fo analyze
REST API Read-only Implemented Unverified GET /api/v1/files/info, GET /api/v1/files/content, GET /api/v1/files/{file_id}
Python SDK Full Implemented Unverified FileOrganizerClient.get_file_info, AsyncFileOrganizerClient.get_file_info, FileOrganizerClient.read_file_content, AsyncFileOrganizerClient.read_file_content, FileOrganizerClient.get_file_by_id, AsyncFileOrganizerClient.get_file_by_id
TypeScript SDK Full Implemented Unverified FileOrganizerClient.getFileInfo, FileOrganizerClient.readFileContent, FileOrganizerClient.getFileById
Web / Desktop Read-only Implemented Unverified GET /ui/files/preview, GET /ui/files/raw, GET /ui/files/thumbnail
TUI Read-only Implemented Unverified FilePreviewView

files.mutate — Direct file mutations

Description: Upload, move, and delete individual files through guarded public operations.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Not-applicable Not-applicable Not-applicable None
REST API Full Implemented Unverified POST /api/v1/files/upload, POST /api/v1/files/move, DELETE /api/v1/files, DELETE /api/v1/files/{file_id}
Python SDK Full Implemented Unverified FileOrganizerClient.move_file, AsyncFileOrganizerClient.move_file, FileOrganizerClient.delete_file, AsyncFileOrganizerClient.delete_file, FileOrganizerClient.delete_file_by_id, AsyncFileOrganizerClient.delete_file_by_id, FileOrganizerClient.upload_files, AsyncFileOrganizerClient.upload_files
TypeScript SDK Full Implemented Unverified FileOrganizerClient.moveFile, FileOrganizerClient.deleteFile, FileOrganizerClient.deleteFileById, FileOrganizerClient.uploadFiles
Web / Desktop Full Partial Unverified POST /ui/files/upload
TUI Not-applicable Not-applicable Not-applicable None

history.manage — Operation history and undo

Description: Review operation history and perform supported undo and redo actions.

  • Maturity: Stable
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo history, fo undo, fo redo
REST API Full Not-implemented Unverified None
Python SDK Full Not-implemented Unverified None
TypeScript SDK Full Not-implemented Unverified None
Web / Desktop Full Partial Unverified GET /ui/organize/history, GET /ui/organize/history/events, POST /ui/organize/jobs/{job_id}/rollback
TUI Full Partial Unverified UndoHistoryView

integrations.manage — External integrations

Description: Configure, connect, disconnect, and send files through supported integrations.

  • Maturity: Experimental
  • Execution Scopes: remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Not-applicable Not-applicable Not-applicable None
REST API Full Implemented Unverified GET /api/v1/integrations, POST /api/v1/integrations/{integration_name}/settings, POST /api/v1/integrations/{integration_name}/connect, POST /api/v1/integrations/{integration_name}/disconnect, POST /api/v1/integrations/{integration_name}/send, GET /api/v1/integrations/browser/config, POST /api/v1/integrations/browser/token, POST /api/v1/integrations/browser/verify
Python SDK Full Implemented Unverified FileOrganizerClient.list_integrations, AsyncFileOrganizerClient.list_integrations, FileOrganizerClient.update_integration_settings, AsyncFileOrganizerClient.update_integration_settings, FileOrganizerClient.connect_integration, AsyncFileOrganizerClient.connect_integration, FileOrganizerClient.disconnect_integration, AsyncFileOrganizerClient.disconnect_integration, FileOrganizerClient.send_to_integration, AsyncFileOrganizerClient.send_to_integration, FileOrganizerClient.get_browser_integration_config, AsyncFileOrganizerClient.get_browser_integration_config, FileOrganizerClient.issue_browser_integration_token, AsyncFileOrganizerClient.issue_browser_integration_token, FileOrganizerClient.verify_browser_integration_token, AsyncFileOrganizerClient.verify_browser_integration_token
TypeScript SDK Full Implemented Unverified FileOrganizerClient.listIntegrations, FileOrganizerClient.updateIntegrationSettings, FileOrganizerClient.connectIntegration, FileOrganizerClient.disconnectIntegration, FileOrganizerClient.sendToIntegration, FileOrganizerClient.getBrowserIntegrationConfig, FileOrganizerClient.issueBrowserIntegrationToken, FileOrganizerClient.verifyBrowserIntegrationToken
Web / Desktop Not-applicable Not-applicable Not-applicable None
TUI Not-applicable Not-applicable Not-applicable None

interfaces.launch — Interactive interface launchers

Description: Launch the supported local Web, Desktop, and terminal user interfaces.

  • Maturity: Stable
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: desktop

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo serve, fo desktop, fo tui
REST API Not-applicable Not-applicable Not-applicable None
Python SDK Not-applicable Not-applicable Not-applicable None
TypeScript SDK Not-applicable Not-applicable Not-applicable None
Web / Desktop Not-applicable Not-applicable Not-applicable None
TUI Not-applicable Not-applicable Not-applicable None

marketplace.manage — Plugin marketplace

Description: Browse, inspect, install, remove, update, and review marketplace plugins.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo marketplace list, fo marketplace search, fo marketplace info, fo marketplace install, fo marketplace uninstall, fo marketplace update, fo marketplace installed, fo marketplace updates, fo marketplace review
REST API Full Implemented Unverified GET /api/v1/marketplace/plugins, GET /api/v1/marketplace/plugins/{name}, GET /api/v1/marketplace/installed, GET /api/v1/marketplace/updates, POST /api/v1/marketplace/plugins/{name}/install, DELETE /api/v1/marketplace/plugins/{name}, POST /api/v1/marketplace/plugins/{name}/update, GET /api/v1/marketplace/plugins/{name}/reviews, POST /api/v1/marketplace/plugins/{name}/reviews
Python SDK Full Implemented Unverified FileOrganizerClient.list_marketplace_plugins, AsyncFileOrganizerClient.list_marketplace_plugins, FileOrganizerClient.get_marketplace_plugin, AsyncFileOrganizerClient.get_marketplace_plugin, FileOrganizerClient.list_installed_plugins, AsyncFileOrganizerClient.list_installed_plugins, FileOrganizerClient.list_marketplace_updates, AsyncFileOrganizerClient.list_marketplace_updates, FileOrganizerClient.install_marketplace_plugin, AsyncFileOrganizerClient.install_marketplace_plugin, FileOrganizerClient.uninstall_marketplace_plugin, AsyncFileOrganizerClient.uninstall_marketplace_plugin, FileOrganizerClient.update_marketplace_plugin, AsyncFileOrganizerClient.update_marketplace_plugin, FileOrganizerClient.list_marketplace_reviews, AsyncFileOrganizerClient.list_marketplace_reviews, FileOrganizerClient.add_marketplace_review, AsyncFileOrganizerClient.add_marketplace_review
TypeScript SDK Full Implemented Unverified FileOrganizerClient.listMarketplacePlugins, FileOrganizerClient.getMarketplacePlugin, FileOrganizerClient.listInstalledPlugins, FileOrganizerClient.listMarketplaceUpdates, FileOrganizerClient.installMarketplacePlugin, FileOrganizerClient.uninstallMarketplacePlugin, FileOrganizerClient.updateMarketplacePlugin, FileOrganizerClient.listMarketplaceReviews, FileOrganizerClient.addMarketplaceReview
Web / Desktop Full Implemented Unverified GET /ui/marketplace, GET /ui/marketplace/plugins/{name}/details, POST /ui/marketplace/plugins/{name}/install, POST /ui/marketplace/plugins/{name}/uninstall, POST /ui/marketplace/plugins/{name}/update
TUI Not-applicable Not-applicable Not-applicable None

methodology.configure — Organization methodology

Description: Select and configure default, PARA, or Johnny Decimal organization policy.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Verified fo config edit, fo organize --methodology, fo preview --methodology, fo api organize --methodology, fo api preview --methodology
REST API Full Partial Unverified GET /api/v1/config, PUT /api/v1/config
Python SDK Full Implemented Unverified FileOrganizerClient.get_application_config, AsyncFileOrganizerClient.get_application_config, FileOrganizerClient.update_application_config, AsyncFileOrganizerClient.update_application_config
TypeScript SDK Full Implemented Unverified FileOrganizerClient.getApplicationConfig, FileOrganizerClient.updateApplicationConfig
Web / Desktop Full Partial Unverified GET /ui/settings/organization, POST /ui/settings/organization/validate, POST /ui/settings/organization
TUI Full Implemented Unverified MethodologyView

models.manage — AI model management

Description: Inspect, acquire, select, test, and cache supported AI models.

  • Maturity: Beta
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: cloud, claude, llama, mlx

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo model list, fo model pull, fo model cache
REST API Not-applicable Not-applicable Not-applicable None
Python SDK Not-applicable Not-applicable Not-applicable None
TypeScript SDK Not-applicable Not-applicable Not-applicable None
Web / Desktop Full Implemented Unverified GET /ui/settings/models, POST /ui/settings/models, POST /ui/settings/models/test
TUI Full Partial Unverified SettingsView

organization.execute — Organization execution

Description: Apply an approved organization plan and return normalized operation results.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Verified fo organize, fo api organize
REST API Full Implemented Verified POST /api/v1/organize/execute
Python SDK Full Implemented Verified FileOrganizerClient.organize, AsyncFileOrganizerClient.organize
TypeScript SDK Full Implemented Verified FileOrganizerClient.organize
Web / Desktop Full Implemented Verified POST /ui/organize/execute
TUI Full Implemented Verified TUIOrganizationAdapter.execute

organization.jobs-recovery — Organization jobs and recovery

Description: Observe, cancel, roll back, and recover organization work using stable lifecycle semantics.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Partial Unverified fo recover, fo undo, fo history, fo api job, fo api jobs, fo api cancel, fo api rollback
REST API Full Implemented Unverified GET /api/v1/organize/status/{job_id}, GET /api/v1/organize/jobs, POST /api/v1/organize/jobs/{job_id}/cancel, POST /api/v1/organize/jobs/{job_id}/rollback, WS /api/v1/ws/{client_id}
Python SDK Full Implemented Unverified FileOrganizerClient.get_job, AsyncFileOrganizerClient.get_job, FileOrganizerClient.list_jobs, AsyncFileOrganizerClient.list_jobs, FileOrganizerClient.cancel_job, AsyncFileOrganizerClient.cancel_job, FileOrganizerClient.rollback_job, AsyncFileOrganizerClient.rollback_job
TypeScript SDK Full Implemented Unverified FileOrganizerClient.getJob, FileOrganizerClient.listJobs, FileOrganizerClient.cancelJob, FileOrganizerClient.rollbackJob
Web / Desktop Full Implemented Unverified GET /ui/organize/jobs/{job_id}/status, GET /ui/organize/jobs/{job_id}/events, POST /ui/organize/jobs/{job_id}/cancel, POST /ui/organize/jobs/{job_id}/rollback
TUI Full Partial Unverified UndoHistoryView

organization.preview — Organization preview

Description: Build and inspect an organization plan without applying filesystem changes.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Verified fo preview, fo organize --dry-run, fo api preview
REST API Full Implemented Verified POST /api/v1/organize/preview
Python SDK Full Implemented Verified FileOrganizerClient.preview_organize, AsyncFileOrganizerClient.preview_organize
TypeScript SDK Full Implemented Verified FileOrganizerClient.previewOrganize
Web / Desktop Full Implemented Verified GET /ui/organize, POST /ui/organize/scan, POST /ui/organize/plan/clear
TUI Full Implemented Verified TUIOrganizationAdapter.preview

organization.scan — Organization scan

Description: Collect candidate files using the canonical traversal and filtering policy.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Partial Unverified fo preview, fo organize, fo api scan
REST API Full Implemented Verified POST /api/v1/organize/scan
Python SDK Full Implemented Verified FileOrganizerClient.scan, AsyncFileOrganizerClient.scan
TypeScript SDK Full Implemented Verified FileOrganizerClient.scan
Web / Desktop Full Implemented Verified POST /ui/organize/scan
TUI Full Partial Unverified FileBrowserView, OrganizationPreviewView, TUIOrganizationAdapter.scan

organization.suggest — Single-file organization suggestion

Description: Return naming and folder suggestions for one file without applying an organization plan.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Partial Unverified fo api suggest
REST API Full Implemented Unverified POST /api/v1/organize
Python SDK Full Implemented Unverified FileOrganizerClient.suggest_organization, AsyncFileOrganizerClient.suggest_organization
TypeScript SDK Full Implemented Unverified FileOrganizerClient.suggestOrganization
Web / Desktop Full Not-implemented Unverified None
TUI Full Not-implemented Unverified None

plugins.runtime — Plugin runtime API

Description: Expose guarded file, configuration, and lifecycle hook operations to plugins.

  • Maturity: Experimental
  • Execution Scopes: remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Not-applicable Not-applicable Not-applicable None
REST API Full Implemented Unverified GET /api/v1/plugins/files/list, GET /api/v1/plugins/files/metadata, POST /api/v1/plugins/files/organize, GET /api/v1/plugins/config/get, GET /api/v1/plugins/hooks, POST /api/v1/plugins/hooks/register, POST /api/v1/plugins/hooks/unregister, POST /api/v1/plugins/hooks/trigger
Python SDK Full Implemented Unverified FileOrganizerClient.list_plugin_files, AsyncFileOrganizerClient.list_plugin_files, FileOrganizerClient.get_plugin_file_metadata, AsyncFileOrganizerClient.get_plugin_file_metadata, FileOrganizerClient.organize_plugin_file, AsyncFileOrganizerClient.organize_plugin_file, FileOrganizerClient.get_plugin_config, AsyncFileOrganizerClient.get_plugin_config, FileOrganizerClient.register_plugin_hook, AsyncFileOrganizerClient.register_plugin_hook, FileOrganizerClient.unregister_plugin_hook, AsyncFileOrganizerClient.unregister_plugin_hook, FileOrganizerClient.list_plugin_hooks, AsyncFileOrganizerClient.list_plugin_hooks, FileOrganizerClient.trigger_plugin_hook, AsyncFileOrganizerClient.trigger_plugin_hook
TypeScript SDK Full Implemented Unverified FileOrganizerClient.listPluginFiles, FileOrganizerClient.getPluginFileMetadata, FileOrganizerClient.organizePluginFile, FileOrganizerClient.getPluginConfig, FileOrganizerClient.registerPluginHook, FileOrganizerClient.unregisterPluginHook, FileOrganizerClient.listPluginHooks, FileOrganizerClient.triggerPluginHook
Web / Desktop Not-applicable Not-applicable Not-applicable None
TUI Not-applicable Not-applicable Not-applicable None

Description: Search indexed or local files with consistent query and result semantics.

  • Maturity: Stable
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: search

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Read-only Implemented Unverified fo search
REST API Read-only Implemented Unverified GET /api/v1/search
Python SDK Full Implemented Unverified FileOrganizerClient.search, AsyncFileOrganizerClient.search
TypeScript SDK Full Implemented Unverified FileOrganizerClient.search
Web / Desktop Read-only Partial Unverified GET /ui/settings/search
TUI Read-only Partial Unverified FileBrowserView

setup.configure — Initial setup

Description: Discover local capabilities and persist an initial working configuration.

  • Maturity: Stable
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo setup run, fo start, fo quickstart
REST API Full Implemented Unverified GET /api/v1/setup/status, GET /api/v1/setup/capabilities, GET /api/v1/setup/browse-folder, POST /api/v1/setup/complete
Python SDK Full Implemented Unverified FileOrganizerClient.get_setup_status, AsyncFileOrganizerClient.get_setup_status, FileOrganizerClient.detect_setup_capabilities, AsyncFileOrganizerClient.detect_setup_capabilities, FileOrganizerClient.complete_setup, AsyncFileOrganizerClient.complete_setup, FileOrganizerClient.browse_setup_folder, AsyncFileOrganizerClient.browse_setup_folder
TypeScript SDK Full Implemented Unverified FileOrganizerClient.getSetupStatus, FileOrganizerClient.detectSetupCapabilities, FileOrganizerClient.completeSetup, FileOrganizerClient.browseSetupFolder
Web / Desktop Full Implemented Unverified GET /ui/setup, POST /ui/setup/defer
TUI Full Implemented Unverified SetupWizardView

system.inspect — System health and status

Description: Inspect service health, runtime status, hardware capabilities, and storage statistics.

  • Maturity: Stable
  • Execution Scopes: local-only, remote
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Read-only Implemented Unverified fo version, fo doctor, fo hardware-info, fo api capabilities, fo api health, fo api system-status, fo api system-stats
REST API Read-only Implemented Unverified GET /api/v1/health, GET /api/v1/system/status, GET /api/v1/system/stats
Python SDK Full Implemented Unverified FileOrganizerClient.health, AsyncFileOrganizerClient.health, FileOrganizerClient.system_status, AsyncFileOrganizerClient.system_status, FileOrganizerClient.system_stats, AsyncFileOrganizerClient.system_stats
TypeScript SDK Full Implemented Unverified FileOrganizerClient.health, FileOrganizerClient.systemStatus, FileOrganizerClient.systemStats
Web / Desktop Read-only Partial Unverified GET /ui/
TUI Read-only Partial Unverified AnalyticsView

updates.manage — Application updates

Description: Check, install, and roll back supported application updates.

  • Maturity: Stable
  • Execution Scopes: local-only
  • Platforms: linux, macos, windows
  • Optional Dependencies: None

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Implemented Unverified fo update check, fo update install, fo update rollback
REST API Not-applicable Not-applicable Not-applicable None
Python SDK Not-applicable Not-applicable Not-applicable None
TypeScript SDK Not-applicable Not-applicable Not-applicable None
Web / Desktop Not-applicable Not-applicable Not-applicable None
TUI Redirect/deep-link Partial Unverified FileOrganizerApp._check_for_updates

video.analyze — Video analysis

Description: Detect scenes and extract representative keyframes from supported videos.

  • Maturity: Beta
  • Execution Scopes: local-only, remote, auth-gated
  • Platforms: linux, macos, windows
  • Optional Dependencies: video

Surface Status & Entry Points

Surface Target Support Implementation Conformance Entry Points
CLI Full Partial Unverified fo analyze
REST API Full Partial Unverified POST /api/v1/analyze
Python SDK Full Implemented Unverified FileOrganizerClient.analyze, AsyncFileOrganizerClient.analyze
TypeScript SDK Full Implemented Unverified FileOrganizerClient.analyze
Web / Desktop Read-only Partial Unverified GET /ui/files/preview
TUI Not-applicable Not-applicable Not-applicable None