Skip to contents

List installed agents

Source: R/list_agents.R
list_agents.Rd

Returns a data frame describing all agents installed in an agents directory.

Usage

list_agents(path = NULL)

Arguments

path

The agents directory. Can be one of:

  • A known coding agent name such as 'claude_code', 'cursor', or 'github_copilot' (see agent_path() for the full list) to use that agent's conventional project-scope path.

  • A character string giving the directory path directly.

  • NULL (the default), in which case the path is resolved from the WF_AGENT environment variable, or by prompting in interactive sessions. Set WF_AGENT in your .Renviron (e.g. with usethis::edit_r_environ()) to avoid the prompt.

Value

A data frame with columns:

  • name: agent name from frontmatter (or filename stem).

  • description: agent description from frontmatter.

  • source: the source URL or local path the agent was installed from.

  • installed_at: ISO 8601 timestamp of when the agent was installed.

Examples

list_agents(tempfile())
#> [1] name         description  source       installed_at
#> <0 rows> (or 0-length row.names)