Skip to main content
All commands load .env files from the working directory when present.
boolean
Print the installed version and exit.

hyperterse start

Read config, validate the project, package tool scripts, open database connections, and start the HTTP server (MCP and optional A2A routes).
Without arguments, loads .hyperterse from the current directory. A positional path can point to a directory containing .hyperterse or directly to a config file.

Flags

string
default:""
Server port. Overrides config and PORT env var.Short: -pResolution order: --port → server.port → PORT env → 8080
integer
default:"0"
Log verbosity. 1 = error, 2 = warn, 3 = info, 4 = debug. Overrides config.Resolution order: --verbose (4) → --log-level → server.log_level → 3
boolean
default:"false"
Sets log level to 4 (debug). Overrides --log-level.
string
default:""
Configuration as an inline YAML string instead of reading from a file.Short: -s
boolean
default:"false"
Hot-reload on .terse and .ts file changes. Recompiles and restarts automatically.
string
default:""
Comma-separated tag filter. Prefix a tag with - to exclude it.
boolean
default:"false"
Stream logs to /tmp/.hyperterse/logs/ in addition to stdout.

Examples

hyperterse serve

Boot from a pre-built manifest without re-parsing source files.
Without arguments, searches for model.bin in the current directory. A positional argument can point to a directory containing model.bin or directly to a manifest file.

Flags

string
default:""
Server port. Overrides the value embedded in the manifest and PORT env var.Short: -p
integer
default:"0"
Log verbosity. Overrides the value embedded in the manifest.
boolean
default:"false"
Sets log level to 4 (debug).
string
default:""
Comma-separated tag filter.
boolean
default:"false"
Stream logs to file.

Examples

hyperterse build

Compile the project into a deployable output directory.
Without arguments, loads .hyperterse from the current directory.

Flags

string
default:"dist"
Output directory for build artifacts.Short: -o
boolean
default:"false"
Remove the output directory before building.

Output

dist
hyperterse
model.bin
build
vendor.js
tools
<name>
handler.js
input_transform.js
output_transform.js

Examples

hyperterse validate

Check configuration and project structure without starting the server.

Flags

string
default:""
Configuration as an inline YAML string instead of reading from a file.Short: -s

Checks

  • Root config schema compliance
  • Adapter completeness (connector and connection_string required)
  • Tool validity (exactly one of use or handler)
  • Adapter name uniqueness
  • Input type correctness
  • Script file resolution
  • Bundle compilation

Exit codes

Examples

hyperterse init

Scaffold a new project with starter files.

Created files

Does not overwrite existing files.

hyperterse upgrade

Upgrade the installed binary.

Flags

boolean
default:"false"
Include pre-release versions in the upgrade check.
string
Target a specific major version number, or next for the latest major.

Examples

hyperterse completion

Generate shell completion scripts. Hidden from default help.