Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions skills/mfs/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,24 @@ snippet without context.

## First Checks

Before relying on MFS, check that the command exists:
Before relying on MFS, check that the command exists and is the expected CLI:

```bash
mfs --help
mfs --version
```

If `mfs` is not found, the PyPI package name is `mfs-cli` and the installed
command is `mfs`:

```bash
uv tool install mfs-cli
```

After installing, run `mfs --version` again. If installing tools is outside the
current task or requires user approval, report that MFS is not available and
continue with native shell tools such as `grep`, `find`, `rg` when available,
and normal file reads.

If the target folder may not be indexed, inspect status or ask before running a
large indexing job:

Expand Down
19 changes: 19 additions & 0 deletions skills/mfs/references/command-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,25 @@ This reference focuses on command usage for agents. Prefer scoped commands over
global commands when the task gives a path. Use `--json` when another tool will
parse the output.

## Availability Check

Before using MFS, verify that the command is installed:

```bash
mfs --version
```

If the command is missing, install the published CLI package when setup is part
of the task:

```bash
uv tool install mfs-cli
```

The PyPI package name is `mfs-cli`; the installed command is `mfs`. If
installation is not appropriate, fall back to native shell tools and normal file
reads.

## Command Map

| Need | Command |
Expand Down