Scaffold a new tool source directory.
agentc tool init scaffolds a new tool package for the given language with the correct structure,
dependencies, and TDK integration pre-configured.
agentc tool init <NAME> --language <LANGUAGE> [OPTIONS]| Argument | Description |
|---|---|
NAME | Name of the tool package. Used as the package name and as the default directory name. |
| 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. |
Scaffold a Python tool:
agentc tool init weather --language pythonScaffold a JavaScript tool:
agentc tool init math --language javascriptOn success, the command prints:
✓ Created weatherThe generated package is immediately usable. For Python, install dependencies with uv sync. For
JavaScript, install with pnpm install. The TDK dependency and the runtime stubs are pre-configured
in both cases so you can start implementing tool logic right away.
For JavaScript, the command writes a ready-to-use package with the tool development kit, runtime type stub reference, package metadata, and entry point already configured.
For Python, the command writes a ready-to-use package with a pyproject.toml, the tool
development kit dependency, and a typed package directory for the tool implementation.
See Write a tool for details on the tool API and how to declare the tool in your manifest.
© 2026 pogue.dev. All rights reserved.
CC BY 4.0Search the agentc documentation