agentc tool init

Scaffold a new tool source directory.

agentc tool init scaffolds a new tool package for the given language with the correct structure and dependencies pre-configured.

agentc tool init <NAME> --language <LANGUAGE> [OPTIONS]

Arguments

Argument	Description
`NAME`	Name of the tool package. Used as the package name and as the default directory name.

Options

Flag	Short	Default	Description
`--language <LANGUAGE>`	`-l`	required	Language for the tool package. Accepted values: `python`, `javascript`.
`--directory <DIR>`	`-d`	`./<NAME>`	Directory to create the package in.
`--force`		`false`	Overwrite if the target directory already exists and is non-empty.
`--format <FORMAT>`		`auto`	Output format. `auto` selects TTY or plain based on the terminal.

Examples

Scaffold a Python tool:

agentc tool init weather --language python

Scaffold a JavaScript tool:

agentc tool init math --language javascript

Output

On success, the command prints:

 ✓ Created weather

The generated package is immediately usable. For Python, install dependencies with uv sync. For JavaScript, install with pnpm install.

Generated package

For JavaScript, the command writes a ready-to-use package with package metadata, runtime type support, and an entry point that exports a Tool subclass from agentc:tools.

For Python, the command writes a ready-to-use package with a pyproject.toml, runtime type support, and a typed package directory whose module exports a Tool subclass from agentc_tools.

See Write a tool for details on the tool API and how to declare the tool in your manifest.