Skip to main content

​
Tlon

This is a shipped config-backed outbound surface. Tlon inbound serve runtime is not implemented yet

​
At A Glance

FieldValue
Catalog idtlon
Config keytlon
Implementation statusconfig_backed
Transporttlon_urbit_ship_api
Aliasesurbit
Default send target kindconversation

​
Minimal Config

[tlon]
enabled = true
ship = "~zod"
url = "https://ship.example.com"
ship_env = "TLON_SHIP"
url_env = "TLON_URL"
code_env = "TLON_CODE"

​
Smoke Test

loong tlon-send --target "~nec" --text "hello from loong"

​
Command Surface

OperationCommandUsage or status
ship message sendtlon-sendUsage: loong tlon-send [OPTIONS] —target <TARGET> —text <TEXT>
ship event servicetlon-servetlon inbound serve runtime is not implemented yet

​
Required Fields For Send

RequirementConfig pathsEnv pointer pathsDefault env
channel enabledtlon.enabled
tlon.accounts.<account>.enabled		nonenone
shiptlon.ship
tlon.accounts.<account>.ship		tlon.ship_env
tlon.accounts.<account>.ship_env		TLON_SHIP
ship urltlon.url
tlon.accounts.<account>.url		tlon.url_env
tlon.accounts.<account>.url_env		TLON_URL
login codetlon.code
tlon.accounts.<account>.code		tlon.code_env
tlon.accounts.<account>.code_env		TLON_CODE

​
Gateway And Ownership

This surface is a direct-send delivery lane. It does not join multi-channel-serve or the gateway-owned reply-loop contract today.

​
Operator Notes

  • Tlon is the shipped Urbit outbound lane. Inbound serve support remains catalog-only for now.
  • Continue to Channel Guides for the full shipped channel matrix.
  • Continue to Channels for the conceptual surface model.
  • Continue to Channel Setup for the shared public setup contract.