terse-cli 0.1.1

Python CLI for scaffolding and managing Terse projects.

terse-cli

Python CLI for scaffolding, generating, testing, and deploying Terse jobs.

Installation

python -m pip install terse-cli

The CLI installs the published terse-sdk automatically.

Requirements

• Python >=3.11
• uv for working with scaffolded projects

The CLI itself can be installed with pip, but the generated project scaffold uses uv sync and uv run.

Quick Start

terse init my-terse-job
cd my-terse-job
uv sync
terse test

If you connect integrations later, regenerate the project helpers:

terse generate

Commands

• terse init [PROJECT_NAME]
• terse generate
• terse integrate
• terse run [JOB_NAME] --event ... --event-file ...
• terse test [JOB_NAME]
• terse deploy

Supported Generated Helpers

The current Python codegen surface is intentionally small:

• Schedule.cron(...)
• Attio.skill(...)
• Snowflake.skill(...)
• deterministic wrappers on agent.tools.attio and agent.tools.snowflake

terse generate writes these helpers into src/terse_generated.py inside your project.

For example, after generating Snowflake helpers and registering skills=[Snowflake.skill()], a job can call:

from terse_sdk import CronJobInputEvent
from terse_generated import TerseAgent

def handle(event: CronJobInputEvent, agent: TerseAgent) -> None:
    result = agent.tools.snowflake.execute_query(query="select current_date()")
    print(result.rowCount)

Environment Variables

• TERSE_API_KEY: required for terse generate, terse deploy, and any agent/tool calls made by your job
• TERSE_BACKEND_URL: optional backend override for local development
• TERSE_FRONTEND_URL: optional frontend override for local development

Typical Workflow

terse init my-terse-job
cd my-terse-job
uv sync
terse test
terse deploy

To run a job against a serialized event:

terse run --event '{"integrationType":"cron_job","eventType":"manual","formattedContent":"Manual trigger","debugLog":"Manual trigger"}'

Source

• Homepage: useterse.ai
• Repository: github.com/TerseAI/Terse
• Issues: github.com/TerseAI/Terse/issues

Development

If you are working on the CLI itself from the monorepo:

npm run python:setup
npm run python:check
npm run python:build