fcli

f puts a machine-readable CLI on your PATH. Commands are discovered by running f, not declared in a tool schema.

npm i -g @fcli.dev/f

MCP26 tools + exec · prefix cached6,161 tokens

resident · system + 26 tools 3,575

system: You are an agent operating on the user's machine. Use the provided tools to complete the task. Prefer the narrowest tool that answers the question.
{
 "name": "create_or_update_file",
 "description": "Create or update a single file in a GitHub repository",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "path": {
    "type": "string",
    "description": "Path where to create/update the file"
   },
   "content": {
    "type": "string",
    "description": "Content of the file"
   },
   "message": {
    "type": "string",
    "description": "Commit message"
   },
   "branch": {
    "type": "string",
    "description": "Branch to create/update the file in"
   },
   "sha": {
    "type": "string",
    "description": "SHA of the file being replaced (required when updating existing files)"
   }
  },
  "required": [
   "owner",
   "repo",
   "path",
   "content",
   "message",
   "branch"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "search_repositories",
 "description": "Search for GitHub repositories",
 "input_schema": {
  "type": "object",
  "properties": {
   "query": {
    "type": "string",
    "description": "Search query (see GitHub search syntax)"
   },
   "page": {
    "type": "number",
    "description": "Page number for pagination (default: 1)"
   },
   "perPage": {
    "type": "number",
    "description": "Number of results per page (default: 30, max: 100)"
   }
  },
  "required": [
   "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "create_repository",
 "description": "Create a new GitHub repository in your account",
 "input_schema": {
  "type": "object",
  "properties": {
   "name": {
    "type": "string",
    "description": "Repository name"
   },
   "description": {
    "type": "string",
    "description": "Repository description"
   },
   "private": {
    "type": "boolean",
    "description": "Whether the repository should be private"
   },
   "autoInit": {
    "type": "boolean",
    "description": "Initialize with README.md"
   }
  },
  "required": [
   "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "get_file_contents",
 "description": "Get the contents of a file or directory from a GitHub repository",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "path": {
    "type": "string",
    "description": "Path to the file or directory"
   },
   "branch": {
    "type": "string",
    "description": "Branch to get contents from"
   }
  },
  "required": [
   "owner",
   "repo",
   "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "push_files",
 "description": "Push multiple files to a GitHub repository in a single commit",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "branch": {
    "type": "string",
    "description": "Branch to push to (e.g., 'main' or 'master')"
   },
   "files": {
    "type": "array",
    "items": {
     "type": "object",
     "properties": {
      "path": {
       "type": "string"
      },
      "content": {
       "type": "string"
      }
     },
     "required": [
      "path",
      "content"
     ],
     "additionalProperties": false
    },
    "description": "Array of files to push"
   },
   "message": {
    "type": "string",
    "description": "Commit message"
   }
  },
  "required": [
   "owner",
   "repo",
   "branch",
   "files",
   "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "create_issue",
 "description": "Create a new issue in a GitHub repository",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string"
   },
   "repo": {
    "type": "string"
   },
   "title": {
    "type": "string"
   },
   "body": {
    "type": "string"
   },
   "assignees": {
    "type": "array",
    "items": {
     "type": "string"
    }
   },
   "milestone": {
    "type": "number"
   },
   "labels": {
    "type": "array",
    "items": {
     "type": "string"
    }
   }
  },
  "required": [
   "owner",
   "repo",
   "title"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "create_pull_request",
 "description": "Create a new pull request in a GitHub repository",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "title": {
    "type": "string",
    "description": "Pull request title"
   },
   "body": {
    "type": "string",
    "description": "Pull request body/description"
   },
   "head": {
    "type": "string",
    "description": "The name of the branch where your changes are implemented"
   },
   "base": {
    "type": "string",
    "description": "The name of the branch you want the changes pulled into"
   },
   "draft": {
    "type": "boolean",
    "description": "Whether to create the pull request as a draft"
   },
   "maintainer_can_modify": {
    "type": "boolean",
    "description": "Whether maintainers can modify the pull request"
   }
  },
  "required": [
   "owner",
   "repo",
   "title",
   "head",
   "base"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "fork_repository",
 "description": "Fork a GitHub repository to your account or specified organization",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "organization": {
    "type": "string",
    "description": "Optional: organization to fork to (defaults to your personal account)"
   }
  },
  "required": [
   "owner",
   "repo"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "create_branch",
 "description": "Create a new branch in a GitHub repository",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "branch": {
    "type": "string",
    "description": "Name for the new branch"
   },
   "from_branch": {
    "type": "string",
    "description": "Optional: source branch to create from (defaults to the repository's default branch)"
   }
  },
  "required": [
   "owner",
   "repo",
   "branch"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "list_commits",
 "description": "Get list of commits of a branch in a GitHub repository",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string"
   },
   "repo": {
    "type": "string"
   },
   "sha": {
    "type": "string"
   },
   "page": {
    "type": "number"
   },
   "perPage": {
    "type": "number"
   }
  },
  "required": [
   "owner",
   "repo"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "list_issues",
 "description": "List issues in a GitHub repository with filtering options",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string"
   },
   "repo": {
    "type": "string"
   },
   "direction": {
    "type": "string",
    "enum": [
     "asc",
     "desc"
    ]
   },
   "labels": {
    "type": "array",
    "items": {
     "type": "string"
    }
   },
   "page": {
    "type": "number"
   },
   "per_page": {
    "type": "number"
   },
   "since": {
    "type": "string"
   },
   "sort": {
    "type": "string",
    "enum": [
     "created",
     "updated",
     "comments"
    ]
   },
   "state": {
    "type": "string",
    "enum": [
     "open",
     "closed",
     "all"
    ]
   }
  },
  "required": [
   "owner",
   "repo"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "update_issue",
 "description": "Update an existing issue in a GitHub repository",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string"
   },
   "repo": {
    "type": "string"
   },
   "issue_number": {
    "type": "number"
   },
   "title": {
    "type": "string"
   },
   "body": {
    "type": "string"
   },
   "assignees": {
    "type": "array",
    "items": {
     "type": "string"
    }
   },
   "milestone": {
    "type": "number"
   },
   "labels": {
    "type": "array",
    "items": {
     "type": "string"
    }
   },
   "state": {
    "type": "string",
    "enum": [
     "open",
     "closed"
    ]
   }
  },
  "required": [
   "owner",
   "repo",
   "issue_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "add_issue_comment",
 "description": "Add a comment to an existing issue",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string"
   },
   "repo": {
    "type": "string"
   },
   "issue_number": {
    "type": "number"
   },
   "body": {
    "type": "string"
   }
  },
  "required": [
   "owner",
   "repo",
   "issue_number",
   "body"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "search_code",
 "description": "Search for code across GitHub repositories",
 "input_schema": {
  "type": "object",
  "properties": {
   "q": {
    "type": "string"
   },
   "order": {
    "type": "string",
    "enum": [
     "asc",
     "desc"
    ]
   },
   "page": {
    "type": "number",
    "minimum": 1
   },
   "per_page": {
    "type": "number",
    "minimum": 1,
    "maximum": 100
   }
  },
  "required": [
   "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "search_issues",
 "description": "Search for issues and pull requests across GitHub repositories",
 "input_schema": {
  "type": "object",
  "properties": {
   "q": {
    "type": "string"
   },
   "order": {
    "type": "string",
    "enum": [
     "asc",
     "desc"
    ]
   },
   "page": {
    "type": "number",
    "minimum": 1
   },
   "per_page": {
    "type": "number",
    "minimum": 1,
    "maximum": 100
   },
   "sort": {
    "type": "string",
    "enum": [
     "comments",
     "reactions",
     "reactions-+1",
     "reactions--1",
     "reactions-smile",
     "reactions-thinking_face",
     "reactions-heart",
     "reactions-tada",
     "interactions",
     "created",
     "updated"
    ]
   }
  },
  "required": [
   "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "search_users",
 "description": "Search for users on GitHub",
 "input_schema": {
  "type": "object",
  "properties": {
   "q": {
    "type": "string"
   },
   "order": {
    "type": "string",
    "enum": [
     "asc",
     "desc"
    ]
   },
   "page": {
    "type": "number",
    "minimum": 1
   },
   "per_page": {
    "type": "number",
    "minimum": 1,
    "maximum": 100
   },
   "sort": {
    "type": "string",
    "enum": [
     "followers",
     "repositories",
     "joined"
    ]
   }
  },
  "required": [
   "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "get_issue",
 "description": "Get details of a specific issue in a GitHub repository.",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string"
   },
   "repo": {
    "type": "string"
   },
   "issue_number": {
    "type": "number"
   }
  },
  "required": [
   "owner",
   "repo",
   "issue_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "get_pull_request",
 "description": "Get details of a specific pull request",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "list_pull_requests",
 "description": "List and filter repository pull requests",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "state": {
    "type": "string",
    "enum": [
     "open",
     "closed",
     "all"
    ],
    "description": "State of the pull requests to return"
   },
   "head": {
    "type": "string",
    "description": "Filter by head user or head organization and branch name"
   },
   "base": {
    "type": "string",
    "description": "Filter by base branch name"
   },
   "sort": {
    "type": "string",
    "enum": [
     "created",
     "updated",
     "popularity",
     "long-running"
    ],
    "description": "What to sort results by"
   },
   "direction": {
    "type": "string",
    "enum": [
     "asc",
     "desc"
    ],
    "description": "The direction of the sort"
   },
   "per_page": {
    "type": "number",
    "description": "Results per page (max 100)"
   },
   "page": {
    "type": "number",
    "description": "Page number of the results"
   }
  },
  "required": [
   "owner",
   "repo"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "create_pull_request_review",
 "description": "Create a review on a pull request",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   },
   "commit_id": {
    "type": "string",
    "description": "The SHA of the commit that needs a review"
   },
   "body": {
    "type": "string",
    "description": "The body text of the review"
   },
   "event": {
    "type": "string",
    "enum": [
     "APPROVE",
     "REQUEST_CHANGES",
     "COMMENT"
    ],
    "description": "The review action to perform"
   },
   "comments": {
    "type": "array",
    "items": {
     "anyOf": [
      {
       "type": "object",
       "properties": {
        "path": {
         "type": "string",
         "description": "The relative path to the file being commented on"
        },
        "position": {
         "type": "number",
         "description": "The position in the diff where you want to add a review comment"
        },
        "body": {
         "type": "string",
         "description": "Text of the review comment"
        }
       },
       "required": [
        "path",
        "position",
        "body"
       ],
       "additionalProperties": false
      },
      {
       "type": "object",
       "properties": {
        "path": {
         "type": "string",
         "description": "The relative path to the file being commented on"
        },
        "line": {
         "type": "number",
         "description": "The line number in the file where you want to add a review comment"
        },
        "body": {
         "type": "string",
         "description": "Text of the review comment"
        }
       },
       "required": [
        "path",
        "line",
        "body"
       ],
       "additionalProperties": false
      }
     ]
    },
    "description": "Comments to post as part of the review (specify either position or line, not both)"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number",
   "body",
   "event"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "merge_pull_request",
 "description": "Merge a pull request",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   },
   "commit_title": {
    "type": "string",
    "description": "Title for the automatic commit message"
   },
   "commit_message": {
    "type": "string",
    "description": "Extra detail to append to automatic commit message"
   },
   "merge_method": {
    "type": "string",
    "enum": [
     "merge",
     "squash",
     "rebase"
    ],
    "description": "Merge method to use"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "get_pull_request_files",
 "description": "Get the list of files changed in a pull request",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "get_pull_request_status",
 "description": "Get the combined status of all status checks for a pull request",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "update_pull_request_branch",
 "description": "Update a pull request branch with the latest changes from the base branch",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   },
   "expected_head_sha": {
    "type": "string",
    "description": "The expected SHA of the pull request's HEAD ref"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "get_pull_request_comments",
 "description": "Get the review comments on a pull request",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}
{
 "name": "get_pull_request_reviews",
 "description": "Get the reviews on a pull request",
 "input_schema": {
  "type": "object",
  "properties": {
   "owner": {
    "type": "string",
    "description": "Repository owner (username or organization)"
   },
   "repo": {
    "type": "string",
    "description": "Repository name"
   },
   "pull_number": {
    "type": "number",
    "description": "Pull request number"
   }
  },
  "required": [
   "owner",
   "repo",
   "pull_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
 }
}

turn 1 · cumulative 3,640

user: why did the fcli build fail?
I'll look at the recent workflow runs.
{
 "name": "list_commits",
 "input": {
  "owner": "fclidev",
  "repo": "fcli"
 }
}
[] — list_commits requires a commit history argument that the tool schema does not expose for workflow runs. This server has no Actions tool.

turn 2 · cumulative 3,779

No Actions tool exists here. Running the API call directly.
{
 "name": "exec",
 "input": {
  "command": "curl -s -H \"Authorization: Bearer $GITHUB_TOKEN\" \"https://api.github.com/repos/fclidev/fcli/actions/runs?per_page=3\" | jq -c '[.workflow_runs[] | {name, head_branch, status, conclusion}]'"
 }
}
[{"name":"fcli","head_branch":"main","status":"completed","conclusion":"success"},{"name":"fcli","head_branch":"main","status":"completed","conclusion":"success"},{"name":"ci","head_branch":"main","status":"completed","conclusion":"failure"}]

turn 3 · cumulative 3,874

The `ci` run failed. Getting its jobs.
{
 "name": "exec",
 "input": {
  "command": "curl -s -H \"Authorization: Bearer $GITHUB_TOKEN\" \"https://api.github.com/repos/fclidev/fcli/actions/runs/39148294696/jobs\" | jq -c '[.jobs[] | {name, conclusion}]'"
 }
}
[{"name":"build","conclusion":"failure"},{"name":"lint","conclusion":"success"}]

turn 4 · cumulative 6,087

The build job failed. Pulling its log.
{
 "name": "exec",
 "input": {
  "command": "curl -sL -H \"Authorization: Bearer $GITHUB_TOKEN\" \"https://api.github.com/repos/fclidev/fcli/actions/jobs/117736555994/logs\" | gunzip 2>/dev/null | tail -60"
 }
}
2026-07-08T04:16:13.4415230Z ##[group]Runner image: ubuntu-24.04
2026-07-08T04:16:14.3945230Z Version:      2.327.1
2026-07-08T04:16:15.3475230Z Commit:       741c1b3e
2026-07-08T04:16:16.3005230Z OS:           Linux 6.8.0-1042-generic
2026-07-08T04:16:17.2535230Z Architecture: X64
2026-07-08T04:16:18.2065230Z DDIs:       7z, docker, git, node
2026-07-08T04:16:19.1595230Z ##[endgroup]
2026-07-08T04:16:19.1815230Z ##[section]Starting: Job
2026-07-08T04:16:20.1345230Z Current runner version: '2.327.1'
2026-07-08T04:16:21.0875230Z Runner group: 'Default'
2026-07-08T04:16:22.0405230Z Operating System: Ubuntu 24.04.2 LTS
2026-07-08T04:16:22.9935230Z Prepare workflow directory
2026-07-08T04:16:23.9465230Z Prepare all required actions
2026-07-08T04:16:24.8995230Z ##[group]Run actions/checkout@v4
2026-07-08T04:16:24.9215230Z Syncing repository: fclidev/fcli
2026-07-08T04:16:25.8745230Z Action inputs: repository=fclidev/fcli, persist-credentials=true, fetch-depth=1
2026-07-08T04:16:26.8275230Z Got git authentication token
2026-07-08T04:16:27.7805230Z Downloading from: https://github.com/fclidev/fcli
2026-07-08T04:16:28.7335230Z Fetching the repository from https://github.com/fclidev/fcli
2026-07-08T04:16:29.6865230Z HEAD is now at c91f4a2 docs: compare both sides fetching a real Actions log
2026-07-08T04:16:30.6395230Z Cleaning up orphan processes
2026-07-08T04:16:30.6615230Z ##[endgroup]
2026-07-08T04:16:31.6145230Z ##[group]Run actions/setup-node@v4
2026-07-08T04:16:32.5675230Z Found in cache @ /opt/hostedtoolcache/node/22.14.0/x64
2026-07-08T04:16:33.5205230Z Environment details: node 22.14.0, npm 11.2.0
2026-07-08T04:16:34.4735230Z ##[endgroup]
2026-07-08T04:16:35.4265230Z ##[group]Run npm ci
2026-07-08T04:16:36.3795230Z added 214 packages, and audited 215 packages in 24s
2026-07-08T04:16:36.4015230Z 47 packages are looking for funding
2026-07-08T04:16:37.3545230Z found 0 vulnerabilities
2026-07-08T04:16:38.3075230Z ##[endgroup]
2026-07-08T04:16:39.2605230Z ##[group]Run npm run build
2026-07-08T04:16:40.2135230Z bundled 41 modules in 11.3s
2026-07-08T04:16:41.1665230Z dist/index.js  412.3 kB  0 errors
2026-07-08T04:16:42.1195230Z Build complete.
2026-07-08T04:16:42.1415230Z ##[endgroup]
2026-07-08T04:16:43.0945230Z ##[group]Run npm test
2026-07-08T04:16:44.0475230Z  RUN  v2.1.9 /home/runner/work/fcli/fcli
2026-07-08T04:16:45.0005230Z  ✓ tests/registry.test.ts (14 tests) 38ms
2026-07-08T04:16:45.9535230Z  ✓ tests/config.test.ts (9 tests) 21ms
2026-07-08T04:16:46.9065230Z  ✓ tests/store.test.ts (22 tests) 141ms
2026-07-08T04:16:47.8595230Z  ✓ tests/help.test.ts (6 tests) 12ms
2026-07-08T04:16:47.8815230Z  ✓ tests/lock.test.ts (5 tests) 8ms
2026-07-08T04:16:48.8345230Z  ❯ tests/creds.test.ts (31 tests | 1 failed) 902ms
2026-07-08T04:16:49.7875230Z     ✓ creds > unlock starts daemon over unix socket 142ms
2026-07-08T04:16:50.7405230Z     ✓ creds > lock zeroizes key and removes socket 88ms
2026-07-08T04:16:51.6935230Z     ✓ creds > ttl expiry emits expiry event
2026-07-08T04:16:52.6465230Z     ✓ creds > provider refresh returns live value
2026-07-08T04:16:53.5995230Z     ✓ creds > provider error falls back to mirror 311ms
2026-07-08T04:16:53.6215230Z     × creds > provider recovers after transient failure
2026-07-08T04:16:54.5745230Z       → expected undefined to be 'live-9f2c' // Object.is equality
2026-07-08T04:16:55.5275230Z
2026-07-08T04:16:56.4805230Z       Expected: "live-9f2c"
2026-07-08T04:16:57.4335230Z       Received: "undefined"
2026-07-08T04:16:58.3865230Z
2026-07-08T04:16:59.3395230Z          at tests/creds.test.ts:281:31
2026-07-08T04:16:59.3615230Z          279|  const store = await createStore({ ttl: 900 });
2026-07-08T04:17:00.3145230Z          280|  store.setProvider({ name: 'vaultwarden', get: () => {
2026-07-08T04:17:01.2675230Z          281|    if (++attempt < 2) throw new Error('unreachable');
2026-07-08T04:17:02.2205230Z            |                               ^
2026-07-08T04:17:03.1735230Z          282|    return Promise.resolve('live-9f2c');
2026-07-08T04:17:04.1265230Z          283|  } });
2026-07-08T04:17:05.0795230Z
2026-07-08T04:17:05.1015230Z  Test Files  1 failed | 5 passed (6)
2026-07-08T04:17:06.0545230Z       Tests  1 failed | 86 passed (87)
2026-07-08T04:17:07.0075230Z    Start at  04:16:58
2026-07-08T04:17:07.9605230Z    Duration  64.51s (transform 1.02s, setup 0ms, collect 2.11s, tests 1.12s)
2026-07-08T04:17:08.9135230Z ##[error]Process completed with exit code 1.
2026-07-08T04:17:09.8665230Z ##[endgroup]
2026-07-08T04:17:10.8195230Z ##[group]Post Run actions/setup-node@v4
2026-07-08T04:17:10.8415230Z In received shutdown signal, cancelling any in-progress commands
2026-07-08T04:17:11.7945230Z ##[endgroup]
2026-07-08T04:17:12.7475230Z ##[group]Post Run actions/checkout@v4
2026-07-08T04:17:13.7005230Z Deleting local repository
2026-07-08T04:17:14.6535230Z ##[endgroup]
2026-07-08T04:17:15.6065230Z Job completed with result: Failed

turn 5 · cumulative 6,161

The failure is in `tests/creds.test.ts:281` — "provider recovers after transient failure" expected `live-9f2c` and got `undefined`. The provider throws on attempt 1 and your recovery path in src/store.ts:277 does not retry; it serves the last mirror instead of calling again. 86 other tests pass.

fbash + jq + index · prefix cached4,478 tokens

resident · system + 1 tools 95

system: You are an agent operating on the user's machine. Use the bash tool to run commands. Run `f` to list capabilities. Prefer the narrowest command that answers the question.
{
 "name": "bash",
 "description": "Run a shell command and return stdout and stderr. The shell has the usual coreutils, jq, curl and git available.",
 "input_schema": {
  "type": "object",
  "properties": {
   "command": {
    "type": "string",
    "description": "command to run"
   }
  },
  "required": [
   "command"
  ]
 }
}

turn 1 · cumulative 166

user: why did the fcli build fail?
I'll check the recent Actions runs.
{
 "name": "bash",
 "input": {
  "command": "f"
 }
}
f v0.3.3

config     fj         ha         providers  ssh        
creds      gh         ha-ws      search     uck        
df         grocy      pi-models  skills     v          

turn 2 · cumulative 302

`gh` is the GitHub uck. Piping through jq, since the runs endpoint returns the repository object twice per run.
{
 "name": "bash",
 "input": {
  "command": "f gh GET /repos/fclidev/fcli/actions/runs?per_page=3 | jq -c '[.workflow_runs[] | {name, head_branch, status, conclusion}]'"
 }
}
[{"name":"fcli","head_branch":"main","status":"completed","conclusion":"success"},{"name":"fcli","head_branch":"main","status":"completed","conclusion":"success"},{"name":"ci","head_branch":"main","status":"completed","conclusion":"failure"}]

turn 3 · cumulative 2,216

The `ci` run failed. Getting its jobs.
{
 "name": "bash",
 "input": {
  "command": "f gh GET /repos/fclidev/fcli/actions/runs/39148294696/jobs"
 }
}
{
  "total_count": 2,
  "jobs": [
    {
      "id": 117736555994,
      "run_id": 39148294696,
      "node_id": "CR_kwDOVAPCGMTE3NzM2N",
      "name": "build",
      "status": "completed",
      "conclusion": "failure",
      "workflow_name": "fcli",
      "run_url": "https://api.github.com/repos/fclidev/fcli/actions/runs/39148294696",
      "run_attempt": 1,
      "attempt": 1,
      "html_url": "https://github.com/fclidev/fcli/actions/runs/39148294696/job/117736555994",
      "url": "https://api.github.com/repos/fclidev/fcli/actions/jobs/117736555994",
      "check_run_url": "https://api.github.com/repos/fclidev/fcli/check-runs/117736555994",
      "logs": "https://api.github.com/repos/fclidev/fcli/actions/jobs/117736555994/logs",
      "head_branch": "main",
      "head_sha": "c91f4a2e8b3d7f6a0c4e9b2d5f8a1c7e3b6d0f94",
      "labels": [],
      "runner_id": 297480,
      "runner_name": "GitHub Actions Linux",
      "runner_group_id": 2,
      "runner_group_name": "Default",
      "created_at": "2026-07-08T04:16:05Z",
      "started_at": "2026-07-08T04:16:12Z",
      "completed_at": "2026-07-08T04:21:47Z",
      "steps": [
        {
          "name": "Set up job",
          "status": "completed",
          "conclusion": "success",
          "number": 1,
          "started_at": "2026-07-08T04:16:12Z",
          "completed_at": "2026-07-08T04:16:20Z"
        },
        {
          "name": "Run actions/checkout@v4",
          "status": "completed",
          "conclusion": "success",
          "number": 2,
          "started_at": "2026-07-08T04:16:13Z",
          "completed_at": "2026-07-08T04:16:21Z"
        },
        {
          "name": "Run actions/setup-node@v4",
          "status": "completed",
          "conclusion": "success",
          "number": 3,
          "started_at": "2026-07-08T04:16:14Z",
          "completed_at": "2026-07-08T04:16:22Z"
        },
        {
          "name": "Run npm ci",
          "status": "completed",
          "conclusion": "success",
          "number": 4,
          "started_at": "2026-07-08T04:16:15Z",
          "completed_at": "2026-07-08T04:17:23Z"
        },
        {
          "name": "Run npm run build",
          "status": "completed",
          "conclusion": "success",
          "number": 5,
          "started_at": "2026-07-08T04:16:16Z",
          "completed_at": "2026-07-08T04:17:24Z"
        },
        {
          "name": "Run npm test",
          "status": "completed",
          "conclusion": "failure",
          "number": 6,
          "started_at": "2026-07-08T04:16:17Z",
          "completed_at": "2026-07-08T04:17:25Z"
        },
        {
          "name": "Post Run actions/setup-node@v4",
          "status": "completed",
          "conclusion": "success",
          "number": 7,
          "started_at": "2026-07-08T04:16:18Z",
          "completed_at": "2026-07-08T04:18:26Z"
        },
        {
          "name": "Post Run actions/checkout@v4",
          "status": "completed",
          "conclusion": "success",
          "number": 8,
          "started_at": "2026-07-08T04:16:19Z",
          "completed_at": "2026-07-08T04:18:27Z"
        },
        {
          "name": "Complete job",
          "status": "completed",
          "conclusion": "success",
          "number": 9,
          "started_at": "2026-07-08T04:16:20Z",
          "completed_at": "2026-07-08T04:18:28Z"
        }
      ]
    },
    {
      "id": 117736555998,
      "run_id": 39148294696,
      "node_id": "CR_kwDOVAPCGMTE3NzM2N",
      "name": "lint",
      "status": "completed",
      "conclusion": "success",
      "workflow_name": "fcli",
      "run_url": "https://api.github.com/repos/fclidev/fcli/actions/runs/39148294696",
      "run_attempt": 1,
      "attempt": 1,
      "html_url": "https://github.com/fclidev/fcli/actions/runs/39148294696/job/117736555998",
      "url": "https://api.github.com/repos/fclidev/fcli/actions/jobs/117736555998",
      "check_run_url": "https://api.github.com/repos/fclidev/fcli/check-runs/117736555998",
      "logs": "https://api.github.com/repos/fclidev/fcli/actions/jobs/117736555998/logs",
      "head_branch": "main",
      "head_sha": "c91f4a2e8b3d7f6a0c4e9b2d5f8a1c7e3b6d0f94",
      "labels": [],
      "runner_id": 297480,
      "runner_name": "GitHub Actions Linux",
      "runner_group_id": 2,
      "runner_group_name": "Default",
      "created_at": "2026-07-08T04:16:05Z",
      "started_at": "2026-07-08T04:16:12Z",
      "completed_at": "2026-07-08T04:21:47Z",
      "steps": [
        {
          "name": "Set up job",
          "status": "completed",
          "conclusion": "success",
          "number": 1,
          "started_at": "2026-07-08T04:16:12Z",
          "completed_at": "2026-07-08T04:16:20Z"
        },
        {
          "name": "Run actions/checkout@v4",
          "status": "completed",
          "conclusion": "success",
          "number": 2,
          "started_at": "2026-07-08T04:16:13Z",
          "completed_at": "2026-07-08T04:16:21Z"
        },
        {
          "name": "Run npm ci",
          "status": "completed",
          "conclusion": "success",
          "number": 3,
          "started_at": "2026-07-08T04:16:14Z",
          "completed_at": "2026-07-08T04:16:22Z"
        },
        {
          "name": "Run npm run lint",
          "status": "completed",
          "conclusion": "success",
          "number": 4,
          "started_at": "2026-07-08T04:16:15Z",
          "completed_at": "2026-07-08T04:17:23Z"
        },
        {
          "name": "Complete job",
          "status": "completed",
          "conclusion": "success",
          "number": 5,
          "started_at": "2026-07-08T04:16:16Z",
          "completed_at": "2026-07-08T04:17:24Z"
        }
      ]
    }
  ]
}

turn 4 · cumulative 4,404

Job 117736555994 (build) failed. Pulling its log.
{
 "name": "bash",
 "input": {
  "command": "f gh GET /repos/fclidev/fcli/actions/jobs/117736555994/logs"
 }
}
2026-07-08T04:16:13.4415230Z ##[group]Runner image: ubuntu-24.04
2026-07-08T04:16:14.3945230Z Version:      2.327.1
2026-07-08T04:16:15.3475230Z Commit:       741c1b3e
2026-07-08T04:16:16.3005230Z OS:           Linux 6.8.0-1042-generic
2026-07-08T04:16:17.2535230Z Architecture: X64
2026-07-08T04:16:18.2065230Z DDIs:       7z, docker, git, node
2026-07-08T04:16:19.1595230Z ##[endgroup]
2026-07-08T04:16:19.1815230Z ##[section]Starting: Job
2026-07-08T04:16:20.1345230Z Current runner version: '2.327.1'
2026-07-08T04:16:21.0875230Z Runner group: 'Default'
2026-07-08T04:16:22.0405230Z Operating System: Ubuntu 24.04.2 LTS
2026-07-08T04:16:22.9935230Z Prepare workflow directory
2026-07-08T04:16:23.9465230Z Prepare all required actions
2026-07-08T04:16:24.8995230Z ##[group]Run actions/checkout@v4
2026-07-08T04:16:24.9215230Z Syncing repository: fclidev/fcli
2026-07-08T04:16:25.8745230Z Action inputs: repository=fclidev/fcli, persist-credentials=true, fetch-depth=1
2026-07-08T04:16:26.8275230Z Got git authentication token
2026-07-08T04:16:27.7805230Z Downloading from: https://github.com/fclidev/fcli
2026-07-08T04:16:28.7335230Z Fetching the repository from https://github.com/fclidev/fcli
2026-07-08T04:16:29.6865230Z HEAD is now at c91f4a2 docs: compare both sides fetching a real Actions log
2026-07-08T04:16:30.6395230Z Cleaning up orphan processes
2026-07-08T04:16:30.6615230Z ##[endgroup]
2026-07-08T04:16:31.6145230Z ##[group]Run actions/setup-node@v4
2026-07-08T04:16:32.5675230Z Found in cache @ /opt/hostedtoolcache/node/22.14.0/x64
2026-07-08T04:16:33.5205230Z Environment details: node 22.14.0, npm 11.2.0
2026-07-08T04:16:34.4735230Z ##[endgroup]
2026-07-08T04:16:35.4265230Z ##[group]Run npm ci
2026-07-08T04:16:36.3795230Z added 214 packages, and audited 215 packages in 24s
2026-07-08T04:16:36.4015230Z 47 packages are looking for funding
2026-07-08T04:16:37.3545230Z found 0 vulnerabilities
2026-07-08T04:16:38.3075230Z ##[endgroup]
2026-07-08T04:16:39.2605230Z ##[group]Run npm run build
2026-07-08T04:16:40.2135230Z bundled 41 modules in 11.3s
2026-07-08T04:16:41.1665230Z dist/index.js  412.3 kB  0 errors
2026-07-08T04:16:42.1195230Z Build complete.
2026-07-08T04:16:42.1415230Z ##[endgroup]
2026-07-08T04:16:43.0945230Z ##[group]Run npm test
2026-07-08T04:16:44.0475230Z  RUN  v2.1.9 /home/runner/work/fcli/fcli
2026-07-08T04:16:45.0005230Z  ✓ tests/registry.test.ts (14 tests) 38ms
2026-07-08T04:16:45.9535230Z  ✓ tests/config.test.ts (9 tests) 21ms
2026-07-08T04:16:46.9065230Z  ✓ tests/store.test.ts (22 tests) 141ms
2026-07-08T04:16:47.8595230Z  ✓ tests/help.test.ts (6 tests) 12ms
2026-07-08T04:16:47.8815230Z  ✓ tests/lock.test.ts (5 tests) 8ms
2026-07-08T04:16:48.8345230Z  ❯ tests/creds.test.ts (31 tests | 1 failed) 902ms
2026-07-08T04:16:49.7875230Z     ✓ creds > unlock starts daemon over unix socket 142ms
2026-07-08T04:16:50.7405230Z     ✓ creds > lock zeroizes key and removes socket 88ms
2026-07-08T04:16:51.6935230Z     ✓ creds > ttl expiry emits expiry event
2026-07-08T04:16:52.6465230Z     ✓ creds > provider refresh returns live value
2026-07-08T04:16:53.5995230Z     ✓ creds > provider error falls back to mirror 311ms
2026-07-08T04:16:53.6215230Z     × creds > provider recovers after transient failure
2026-07-08T04:16:54.5745230Z       → expected undefined to be 'live-9f2c' // Object.is equality
2026-07-08T04:16:55.5275230Z
2026-07-08T04:16:56.4805230Z       Expected: "live-9f2c"
2026-07-08T04:16:57.4335230Z       Received: "undefined"
2026-07-08T04:16:58.3865230Z
2026-07-08T04:16:59.3395230Z          at tests/creds.test.ts:281:31
2026-07-08T04:16:59.3615230Z          279|  const store = await createStore({ ttl: 900 });
2026-07-08T04:17:00.3145230Z          280|  store.setProvider({ name: 'vaultwarden', get: () => {
2026-07-08T04:17:01.2675230Z          281|    if (++attempt < 2) throw new Error('unreachable');
2026-07-08T04:17:02.2205230Z            |                               ^
2026-07-08T04:17:03.1735230Z          282|    return Promise.resolve('live-9f2c');
2026-07-08T04:17:04.1265230Z          283|  } });
2026-07-08T04:17:05.0795230Z
2026-07-08T04:17:05.1015230Z  Test Files  1 failed | 5 passed (6)
2026-07-08T04:17:06.0545230Z       Tests  1 failed | 86 passed (87)
2026-07-08T04:17:07.0075230Z    Start at  04:16:58
2026-07-08T04:17:07.9605230Z    Duration  64.51s (transform 1.02s, setup 0ms, collect 2.11s, tests 1.12s)
2026-07-08T04:17:08.9135230Z ##[error]Process completed with exit code 1.
2026-07-08T04:17:09.8665230Z ##[endgroup]
2026-07-08T04:17:10.8195230Z ##[group]Post Run actions/setup-node@v4
2026-07-08T04:17:10.8415230Z In received shutdown signal, cancelling any in-progress commands
2026-07-08T04:17:11.7945230Z ##[endgroup]
2026-07-08T04:17:12.7475230Z ##[group]Post Run actions/checkout@v4
2026-07-08T04:17:13.7005230Z Deleting local repository
2026-07-08T04:17:14.6535230Z ##[endgroup]
2026-07-08T04:17:15.6065230Z Job completed with result: Failed

turn 5 · cumulative 4,478

The failure is in `tests/creds.test.ts:281` — "provider recovers after transient failure" expected `live-9f2c` and got `undefined`. The provider throws on attempt 1 and your recovery path in src/store.ts:277 does not retry; it serves the last mirror instead of calling again. 86 other tests pass.

f is a command line interface for LLM agents. It is a single executable on PATH; an agent learns its commands by running f, not from a declared tool schema. A command costs nothing until invoked, and the always-present cost is a name index rather than a description per command.

Context cost against MCP

Three costs, compared assuming both sides use their best strategy: MCP with prefix caching and tools/list discovery, f with its name grid.

Discovery. MCP: one tools/list call, full definitions cached from then on. f: one f call, 36-token name grid cached from then on. Both are paid once per session. Per capability, the f grid costs 5.1 tokens (36 / 7 ucks on a fresh install); a single MCP tool definition costs 77.6–963 tokens.

Compute. Re-reading a prompt prefix is what makes a request slow. Prefix caching removes that: the tool definitions are tokenized into the model once, and a later request that repeats the same bytes skips the reprocessing. If the definitions are stable, their compute cost is paid once.

The bytes are still there. The API is stateless, so every request carries the tool list in its body, and the model only “knows” a tool exists because it is in the tokens it is being fed right now. Caching discounts the rate, not the presence: cached input is billed at 10% of base on Anthropic, up to 95% off on OpenAI, against 100% on a miss.

f MCP, cached + tools/list
Discovery, per capability 5.1 tokens (36 / 7) 77.6–963 tokens (one def)
In the body, per request never (names are runtime output) full definition
Re-processed, per request never not after the first
Steady-state billing ≈ 0 definition × 10–50%
A tool never called 0 definition × 10–50%
Occupies the context window no always

The first request always pays full, and so does every request after the bytes change. Caching is a prefix match on exact bytes: one tool added, removed, or reworded invalidates everything at and after it, back to full price. That is the uncached column, and it is what a server whose tool surface drifts between requests actually pays.

So the defensible claims are the two the cache does not remove:

  • the definitions always occupy the context window, cached or not — 77.6 to 963 tokens each, and 56 of them take 16.9% of a 200k window before the first user message;
  • their compute cost is the only one caching removes, and only while the bytes are stable.

Discovery does not fix either: tools/list puts the full definitions in the context window, and caching only discounts their rate. f has neither failure mode: the name grid is 36 tokens that occupy 0.02% of a 200k window, and it is paid once.

No host process on the f side: one binary on PATH, no daemon. Details in Why a CLI and not MCP.

Why a CLI and not MCP

No host process. An MCP server is installed, configured, and kept running. f is one executable on PATH: no daemon, no handshake, no protocol version negotiation.

Discovery at runtime, in two steps. f prints the names of every installed uck; f search <query> ranks them against what you are trying to do, and f <uck> --help gives the detail for one. Both are generated from the store at invocation time, so they reflect what is actually installed rather than a manifest that can drift. Output is plain text: no colors, no banner, no completion message.

Extension is a directory. A command is a directory containing index.js. Adding it to the store, or npm i-ing a package, makes it available on the next invocation. Extensions run in the full Node.js runtime — child_process, fs, http, the network. There is no sandbox, no manifest review, and no restart.

Runtime and safety

There is no sandbox. Code in the store executes with full process privileges: it can read credentials, files, and anything else the invoking user can reach. f does not vet ucks.

Two mechanisms limit the blast radius, and neither is a sandbox:

  • Stored credentials expire. f creds holds values behind a TTL, after which a lookup misses. It bounds how long a secret stays readable; it does not restrict what running code can do.
  • Name collisions resolve by source order, not by trust. The later source wins — project config is read after global, so a project uck overrides a same-named default. Both copies stay installed; only one loads. See Shadowing.

Installing a source means trusting it: f config add ucks <source> accepts an arbitrary GitHub repo or npm package. See Config.

Terms

  • Uck — one unit of f functionality: a directory with an index.js that exports register(ctx). Builtins, extensions, and your own commands are all ucks, differing only in which source installed them. Details: Ucks.
  • Store — ~/.f/ucks/<bucket>/. Every uck f has loaded. The bucket name is part of the path, so a git-sourced uck sits in its own clone and git blame works against installed commands. Layout: The store.
  • Config — f.config.json, global and project scopes merged, listing uck sources and skills. Format and keys: Config.

Ucks on npm

  • Ucks — packages tagged fcli-uck, resolved live against npm. It sits outside the documentation tree above and outside the sidebar: it reports what is published, which changes without a rebuild.

Source: github.com/fclidev/fcli · Default ucks: github.com/fclidev/fcli-ucks

Documentation for f. This page is built by the site generator.

site source