Obelisk Components

May 26, 2026 ยท View on GitHub

Reusable components for Obelisk. Each component folder contains a README.md and a *-oci.toml deployment file with the component's OCI reference. Components can be added to a local deployment.toml copying *-oci.toml sections or by using obelisk component add.

Components

Activities

Activities are components that perform side effects (HTTP calls, database operations, etc.).

ComponentDescription
activity-dockerDocker container management using exec activities
activity-fly-httpFly.io API (apps, machines, secrets, volumes)
activity-github-graphqlGitHub GraphQL API (account info, stargazers)
activity-http-genericGeneric HTTP client
activity-obelisk-client-httpObelisk API client
activity-openai-responsesOpenAI Responses API
activity-postmark-emailPostmark email API
activity-sendgrid-emailSendGrid email API

Webhooks

Webhooks are HTTP endpoint handlers that receive external events.

ComponentDescription
webhook-fly-secrets-updaterWASM webhook that directly calls fly's secrets endpoint

Adding components

Use

obelisk component add oci://docker.io/repo/image:tag new_name --locked -d deployment.toml

to add a component to a local deployment file.

Export WITs of all external components:

obelisk generate wit-deps -d deployment.toml --skip-local ./wit