Skip to content

SDK and Host API

The TypeScript SDK lives in @haloforge/plugin-sdk.

Install:

Terminal window
npm i @haloforge/plugin-sdk react react-dom @tauri-apps/api lucide-react

Use it for:

  • plugin registration
  • Rust command invocation
  • host navigation
  • host theme tokens
  • AIChat model and transport access
  • host file dialogs
  • host events
  • host-styled controls such as AppSelect
  • managed image gateway access
Manifest capabilitySDK surface
navigationuseHostNavigation()
app_stateuseHostAppState()
file_intentsuseHostFileIntent()
file_dialogspickHostFile(), pickHostDirectory(), saveHostFile()
aichatuseHostAI()
enterprise_gatewayenterpriseGateway()
theme_readuseHostTheme()
event_subscribeuseHostEvent()

If plugin code needs a host behavior not listed here, add a documented SDK helper instead of reaching into private host state.