CLI Command Reference

Installation

curl -fsSL https://cli.datagen.dev/install.sh | sh

Windows:

irm https://cli.datagen.dev/install.ps1 | iex

Verify: datagen --help

Authenticate with DataGen via browser OAuth or API key.

datagen login
datagen login --api-key "your-key"

Flag	Short	Type	Default	Description
`--api-key`		string		API key (skips browser login)
`--shell`		string		Shell type: bash, zsh, fish, powershell
`--profile`		string		Shell profile file to update
`--env`		string	`DATAGEN_API_KEY`	Environment variable name
`--yes`	`-y`	bool	false	Skip confirmation prompts
`--print`		bool	false	Print export command only

`datagen mcp`

Configure the DataGen MCP server in local tools (Codex, Claude, Gemini).

datagen mcp
datagen mcp --clients claude,codex --dry-run

Flag	Short	Type	Default	Description
`--clients`		string	`codex,claude,gemini`	Comma-separated clients to configure
`--api-key`		string		API key (uses env/profile lookup if empty)
`--env`		string	`DATAGEN_API_KEY`	Environment variable to look up
`--yes`	`-y`	bool	false	Skip confirmation prompts
`--dry-run`		bool	false	Show changes without writing
`--codex-static`		bool	false	Use static header in Codex config

`datagen github`

Manage GitHub connection and repository access.

`github connect`

Install the DataGen GitHub App via browser.

datagen github connect

Flag	Type	Default	Description
`--timeout`	int	300	Seconds to wait for installation

`github repos`

List all repositories accessible via your GitHub App.

datagen github repos

`github connected`

List repositories already connected to DataGen.

datagen github connected

`github connect-repo`

Connect a specific repository.

datagen github connect-repo owner/repo

Argument: <owner/repo> (required)

`github sync`

Re-sync agents from a connected repository.

datagen github sync <repo-id>

Argument: <repo-id> (required)

`github status`

Check GitHub App installation status.

datagen github status

`datagen agents`

Manage agents, skills, and commands discovered from GitHub repositories.

`agents list`

List all discovered agents.

datagen agents list
datagen agents list --type agent --deployed

Flag	Type	Default	Description
`--repo`	string		Filter by repository (owner/repo)
`--type`	string		Filter: `agent`, `skill`, or `command`
`--deployed`	bool	false	Show only deployed agents

`agents show`

Show detailed info about an agent.

datagen agents show <agent-id>

`agents deploy`

Deploy an agent to DataGen.

datagen agents deploy <agent-id>

`agents undeploy`

Remove an agent deployment and its webhook.

datagen agents undeploy <agent-id>

`agents run`

Trigger an agent execution.

datagen agents run <agent-id>
datagen agents run <agent-id> --payload '{"task": "review PRs"}'

Flag	Type	Default	Description
`--payload`	string	`"{}"`	JSON payload for the run

`agents logs`

View execution history.

datagen agents logs <agent-id>
datagen agents logs <agent-id> --limit 20

Flag	Type	Default	Description
`--limit`	int	10	Max executions to show

`agents output`

Show execution output.

datagen agents output <agent-id>
datagen agents output <agent-id> --execution <exec-id>

Flag	Type	Default	Description
`--execution`	string		Specific execution ID
`--session`	string		SDK session ID to look up
`--json`	bool	false	Output raw JSON

`agents config`

View or update agent configuration. With no flags, displays current config.

datagen agents config <agent-id>
datagen agents config <agent-id> --set-prompt "Review all open PRs"
datagen agents config <agent-id> --secrets ANTHROPIC_API_KEY,GITHUB_TOKEN

Flag	Type	Default	Description
`--set-prompt`	string		Set entry prompt
`--clear-prompt`	bool	false	Clear entry prompt
`--secrets`	string		Comma-separated secret names
`--pr-mode`	string		`create_pr`, `auto_merge`, or `skip`
`--add-recipient`	string		Add recipient as `email[:role]`
`--remove-recipient`	string		Remove recipient by ID
`--notify-success`	string		`true`, `false`, or `default`
`--notify-failure`	string		`true`, `false`, or `default`
`--notify-reply`	string		`true`, `false`, or `default`

`agents schedule`

Manage cron schedules. With no flags, lists all schedules.

datagen agents schedule <agent-id>
datagen agents schedule <agent-id> --cron "0 9 * * *" --timezone "America/New_York"
datagen agents schedule <agent-id> --pause <schedule-id>

Flag	Type	Default	Description
`--cron`	string		Cron expression (e.g., `"0 9 * * *"`)
`--timezone`	string	`UTC`	Timezone (e.g., `America/New_York`)
`--name`	string		Optional schedule name
`--pause`	string		Pause a schedule by ID
`--resume`	string		Resume a schedule by ID
`--delete`	string		Delete a schedule by ID

`datagen skills` / `datagen commands`

Aliases for datagen agents with type filtering.

datagen skills list        # Same as: datagen agents list --type skill
datagen commands list      # Same as: datagen agents list --type command

All agents subcommands are available (show, deploy, undeploy, run, logs, output, config, schedule).

`datagen tools`

Manage custom Python tools deployed as API endpoints.

`tools list`

List all custom tools.

datagen tools list

`tools show`

Show custom tool details including code and schemas.

datagen tools show <tool-uuid>

`tools deploy`

Deploy a new custom tool.

datagen tools deploy my_tool --file ./tool.py --description "My tool"
datagen tools deploy my_tool --code "result = 'hello'" --outputs result

Argument: <name> (required)

Flag	Type	Description
`--code`	string	Inline Python code
`--file`	string	Path to Python source file
`--schema`	string	Inline JSON input schema
`--schema-file`	string	Path to JSON schema file
`--defaults`	string	Inline JSON default input values
`--defaults-file`	string	Path to JSON defaults file
`--description`	string	Tool description
`--outputs`	string	Comma-separated output variable names
`--tools`	string	Comma-separated MCP tool names
`--imports`	string	Comma-separated Python packages
`--no-auto-imports`	bool	Disable import inference from source
`--mcp-servers`	string	Comma-separated MCP server names
`--secrets`	string	Comma-separated secret names
`--public`	bool	Deploy as public tool

`tools update`

Update an existing custom tool.

datagen tools update <tool-uuid> --file ./updated_tool.py

Same flags as tools deploy (only provided fields are updated).

`tools run`

Run a custom tool with input.

datagen tools run <tool-uuid> --input '{"domain": "acme.com"}'
datagen tools run <tool-uuid> --input-file ./input.json

Flag	Type	Description
`--input`	string	Inline JSON input variables
`--input-file`	string	Path to JSON input file

`datagen secrets`

Manage API keys and secrets for agents and tools.

`secrets list`

List all stored secrets (values are masked).

datagen secrets list

`secrets set`

Create or update a secret.

datagen secrets set OPENAI_API_KEY=sk-abc123     # Explicit value
datagen secrets set OPENAI_API_KEY                # Read from environment

Argument: <KEY=VALUE> or <KEY> (required)

Environment Variables

Variable	Default	Description
`DATAGEN_API_KEY`		API authentication key
`DATAGEN_API_BASE_URL`	`https://api.datagen.dev`	Custom API server
`DATAGEN_WEB_BASE_URL`	`https://datagen.dev`	Custom web app URL
`DATAGEN_VERSION`		Pin CLI release version during install
`DATAGEN_INSTALL_DIR`		Custom install location

​Installation

​datagen login

​datagen mcp

​datagen github

​github connect

​github repos

​github connected

​github connect-repo

​github sync

​github status

​datagen agents

​agents list

​agents show

​agents deploy

​agents undeploy

​agents run

​agents logs

​agents output

​agents config

​agents schedule

​datagen skills / datagen commands

​datagen tools

​tools list

​tools show

​tools deploy

​tools update

​tools run

​datagen secrets

​secrets list

​secrets set

​Environment Variables