> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# CLI Tools

> Command-line tool for testing agents locally.

[swaig-test]: /docs/server-sdks/reference/typescript/agents/cli/swaig-test

The TypeScript Server SDK ships one command-line tool, `swaig-test`, for local
development. It loads an agent file, renders its SWML, lists its SWAIG
functions, and executes a function with arguments you supply, all without
deploying or placing a call. The package's `bin` entry makes it available
through `npx` after installation.

```bash
npm install @signalwire/sdk
```

## Available tools

| Command                    | Purpose                                               |
| -------------------------- | ----------------------------------------------------- |
| [`swaig-test`][swaig-test] | Test SWAIG functions and generate SWML output locally |

## Local development workflow

```bash
# 1. Inspect the generated SWML
npx swaig-test src/agent.ts --dump-swml

# 2. List available tools
npx swaig-test src/agent.ts --list-tools

# 3. Test a specific function
npx swaig-test src/agent.ts --exec get_info --arg topic=SignalWire
```

> Command-line tool for testing agents locally.

## Docs

- [swaig-test](https://signalwire.com/docs/server-sdks/reference/typescript/agents/cli/swaig-test.md): Test SWAIG functions and generate SWML documents locally without deploying.