Codata CLI

Command-line tool for Codata — manage workspaces, generate typed API clients, configure MCP for your IDE, and interact with your APIs directly from the terminal.

Install

npm install -g codata

Requires Node.js 18+.

Quick Start

# Authenticate (opens browser for OAuth)
codata login

# Create a workspace
codata create my-api -d "User management API"

# List workspaces
codata workspaces

# Configure MCP for your IDE (VS Code, Cursor, Claude Desktop)
codata init

Commands

Authentication

| Command | Description | | --- | --- | | codata login | Authenticate via browser OAuth | | codata login -t <token> | Authenticate with a developer token | | codata logout | Clear stored credentials | | codata whoami | Show current user and auth status |

Workspaces

| Command | Description | | --- | --- | | codata workspaces | List all workspaces | | codata show <name> | Show workspace details (assets, endpoints, relationships) | | codata create <name> | Create a new workspace |

Use --json on workspaces and show to get JSON output.

IDE Setup

# Auto-detect and configure all supported editors
codata init

# Configure a specific editor
codata init -e vscode

# Write to global (user-level) config instead of workspace
codata init -g

Supported editors: VS Code, Cursor, Claude Desktop.

Scaffold

Generate a typed API client from your workspace spec:

# TypeScript (default)
codata scaffold my-api

# Python
codata scaffold my-api --lang python

# JavaScript, write to file
codata scaffold my-api --lang javascript -o client.js

Supported languages: typescript, javascript, python.

Export

Export the workspace's OpenAPI 3.0 spec:

codata export my-api
codata export my-api -o openapi.json

API Requests

Make HTTP requests to a workspace's generated API:

codata api my-api GET /users
codata api my-api POST /users --data '{"name":"Alice","email":"[email protected]"}'
codata api my-api GET /users --query limit=10

Configuration

# Show all config
codata config get

# Show a single value
codata config get serverUrl

# Set a value
codata config set defaultLanguage python

Available settings: serverUrl, defaultLanguage (typescript | javascript | python), outputFormat (table | json).

Config is stored at ~/.codata/config.json. Auth tokens are stored at ~/.codata/auth.json.

Development

git clone https://github.com/codata-io/codata-cli.git
cd codata-cli
npm install
npm run build
node dist/bin/codata.js --help

License

MIT