activefs
v0.1.0
Published
Terminal CLI and TUI for configuring, browsing, mounting, and testing ActiveFS.
Maintainers
Readme
activefs
Terminal CLI for working with ActiveFS remotes, direct tree reads, exports, MCP, status/troubleshooting, and optional mounted folders.
ActiveFS maps dynamic server-owned trees into filesystem-shaped paths. Use this
package when you want the activefs command.
Install
npm install -g activefsRequires Node.js 20 or newer.
Quick Check
activefs --help
activefs remote add repo --demo --port 3999
activefs remote status repo
activefs list /repo
activefs read /repo/README.txt
activefs grep Source /repo --json
activefs remote remove repoConnect a Remote
activefs remote add docs http://127.0.0.1:3999/activefs/v1/
activefs remote status docs
activefs list /docs
activefs read /docs/README.txtTo expose a configured remote as a local folder, run activefs mount docs ./docs
when rclone and the host mount backend are installed.
Host mounted folders are optional and require rclone plus the host mount backend for your platform. Direct commands, exports, TUI, and MCP do not require mount support.
Packages
activefsprovides the user-facing CLI binary.@activefs/clicontains the embeddable CLI implementation.@activefs/corecontains the tree/runtime contracts.
Docs
- Quickstart: https://github.com/ankitparasher/activefs/blob/main/docs/quickstart.md
- CLI: https://github.com/ankitparasher/activefs/blob/main/docs/reference/cli.md
- Changelog: https://github.com/ankitparasher/activefs/blob/main/CHANGELOG.md
