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
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,31 @@ brew upgrade fff-mcp # after new stable releases

Formula lives in [`Formula/fff-mcp.rb`](./Formula/fff-mcp.rb) in this repo and is **auto-bumped on every stable release** (see `bump-homebrew-formula` in [`.github/workflows/release.yaml`](./.github/workflows/release.yaml)). Installs the prebuilt `fff-mcp` binary from [GitHub releases](https://github.com/dmtrKovalenko/fff.nvim/releases).

### Codex setup

Register the installed binary using its absolute path, since Codex desktop sessions may not inherit your interactive shell's `PATH`.

Homebrew:

```bash
codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp"
```

One-line installer:

```bash
codex mcp add fff -- "$HOME/.local/bin/fff-mcp"
```

This creates an entry in `~/.codex/config.toml` similar to:

```toml
[mcp_servers.fff]
command = "/opt/homebrew/bin/fff-mcp"
```

Use the actual installed path for your system, then restart Codex or start a new task so it loads the server.

Once the server is connected, ask the agent to "use fff" and it picks up the `ffgrep`, `fffind`, and `fff-multi-grep` tools.

### Recommended agent prompt
Expand Down
2 changes: 1 addition & 1 deletion install-mcp.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -209,7 +209,7 @@ function Show-SetupInstructions {
if (Get-Command codex -ErrorAction SilentlyContinue) {
$foundAny = $true
Write-Success "[Codex] detected"
Write-Host "codex mcp add fff -- fff-mcp"
Write-Host "codex mcp add fff -- `"$BinaryPath`""
Write-Host ""
}

Expand Down
2 changes: 1 addition & 1 deletion install-mcp.sh
Original file line number Diff line number Diff line change
Expand Up @@ -262,7 +262,7 @@ print_setup_instructions() {
found_any=true
success "[Codex] detected"
echo ""
echo "codex mcp add fff -- fff-mcp"
echo "codex mcp add fff -- \"${binary_path}\""
echo ""
fi

Expand Down
Loading