Wity Agents CLI

Use Wity AI agents directly from your terminal. Chat interactively, get help with code or files, and create content using context from your computer.

Install

npm install -g @wityai/agents-cli

Or use without installing:

npx @wityai/agents-cli login

Quick Start

# 1. Login once (global authentication)
wity login

# 2. Start using immediately
wity                                      # Interactive chat (default profile)
wity --profile coder                      # Interactive chat (coder profile)
wity run "<your query>"                   # Quick run command
wity run "<your query>" --profile coder   # Quick run command with profile

Usage

Interactive Mode

wity                          # Use default profile
wity --profile coder          # Use coder profile

Starts an agentic chat session where you can ask questions about your code and files & have the agent assist you with any tasks. Each profile can have different settings and configurations.

Quick Run Mode

wity run "write a poem about the ocean featuring dolphins"
wity run "are there any unhandled errors in this folder?" --profile coder
wity run "write documentation fort this folder" --profile coder

Profile Management

# Configure profiles with custom settings
wity config set --profile coder

# View profile settings
wity config get --profile coder
wity config get                        # View default profile

# Clear profile
wity config clear --profile old-profile

Other Commands

wity --help              # See all options
wity version             # Show version info

Profiles

Profiles let you maintain different configurations for different use cases:

• Default: General purpose (used when no --profile specified)
• Custom profiles: Any name you want (e.g., coder, writer, debug, work)

Each profile can have its own:

• Agent type and behavior
• API endpoint
• Output format (text, json, table)
• Verbosity settings
• Other custom configurations

Requirements

• Node.js >= 14.0.0
• Internet connection

License

MIT