# Thyme Docs

Build on-chain automation with Flow, the Thyme SDK and CLI, Lift gas sponsorship, Gate RPC, and Atlas subgraphs.

- [Thyme Products](/products): How Flow, the SDK and CLI, Lift gas sponsorship, Gate RPC, and Atlas subgraphs fit together.
- [Thyme Flow](/getting-started/introduction): Write TypeScript tasks, authorize contract calls, and run automation on a schedule or webhook.
- [Installation](/getting-started/installation): Install the current CLI and SDK, and prepare Deno for local task execution.
- [Authentication](/getting-started/authentication): Choose a deployment, authenticate uploads, and grant workspace-scoped management access.
- [Quickstart](/getting-started/quickstart): Run a first task locally, upload an immutable release, and configure its cloud executable.
- [Use Flow in Your Agent](/getting-started/agents): Copy one prompt so Claude Code, Codex, OpenCode, Cursor, and other coding agents can sign in, build tasks, and manage Flow resources with the thyme CLI.
- [Tasks, Releases, Executables, and Executions](/concepts/model): Understand the source-to-execution model and the roles of the SDK, CLI, console, and API.
- [Profiles](/concepts/profiles): Choose an execution identity and understand Roles and legacy authorization.
- [Permission Manifests](/concepts/permissions): Declare contract calls and bind releases only to profiles whose on-chain scope covers them.
- [Chains and Deployment Availability](/concepts/chains): Distinguish configured network support from enabled profiles and live sponsorship.
- [Triggers and Invocations](/concepts/triggers): Schedule executable work with cron or intervals and invoke it manually or by webhook.
- [Gas Modes and Sponsorship](/concepts/gas): Understand sponsored execution, wallet-paid legacy modes, Lift, and dBank settlement.
- [Secrets](/concepts/secrets): Supply sensitive values locally and through project-scoped cloud bindings.
- [Arguments and Schemas](/concepts/args): Validate and transform task arguments while keeping local, executable, and webhook inputs explicit.
- [Persistent Storage](/concepts/storage): Commit JSON state at the correct execution phase and manage cloud storage with version checks.
- [Local and Cloud Execution](/concepts/local-vs-cloud): Compare local Deno runs, cloud runtimes, simulation, lifecycle callbacks, and persistent state.
- [Runtime Limits](/concepts/runtime-limits): Know the execution, storage, manifest, and webhook limits enforced by the current implementation.
- [Author a Task](/build/author-task): Build a validated single-call task with a permission manifest and confirmation callback.
- [Upload a Function Release](/build/upload-function): Bundle source, schema, callbacks, and permissions into an immutable tagged release.
- [Create an Executable](/build/create-executable): Bind a release to arguments, a schedule, secrets, a profile, and a cloud runtime.
- [Flow Console](/console/): Manage project resources, account permissions, execution history, and billing.
- [Executable Lifecycle](/console/executable-lifecycle): Operate executables, change configuration, switch releases, and recover from provisioning failures.
- [Monitoring and Troubleshooting](/console/monitoring): Read execution timelines, inspect logs, and distinguish failure from an unresolved submission.
- [Executable Webhooks](/console/webhooks): Generate secret webhook URLs, validate custom arguments, safely retry requests, and read execution results.
- [Manage Profiles](/console/profiles): Set up, verify, update, and revoke the execution authority attached to a Flow profile.
- [Manage Secrets](/console/secrets): Create, bind, rotate, and remove project secrets without revealing their stored values.
- [API Keys](/console/api-keys): Create, select, and revoke credentials for uploads and scoped workspace management.
- [Usage and Metering](/billing/usage): Separate task execution usage from gas and understand the available telemetry.
- [dBank Gas Credits](/billing/dbank): Understand workspace gas credit, sponsorship reservations, and receipt-based settlement.
- [Management API](/api/): Authenticate and operate Thyme Flow through the workspace-scoped HTTP management API.
- [API Resources & Recipes](/api/resources): Flow management API routes and examples for releases, executable creation, configuration, storage, and webhooks.
- [API Errors & Retries](/api/errors): Handle authentication failures, immutable release conflicts, permission refusals, and retryable Flow management requests.
- [Thyme Flow Management API](/api/reference): Workspace-scoped Flow management API. Reviewed against SDK 0.8.0 / CLI 0.10.0. Mutations require owner/admin membership as well as the stated scope. Deployment-specific profile, gas and runtime restrictions apply.
- [CLI Overview](/cli/): CLI 0.10.0 for authoring, running, uploading, managing, and independently verifying Thyme Flow automation.
- [thyme init](/cli/init): Scaffold a new Thyme Flow project directory with the SDK, CLI, and TypeScript configuration ready to go.
- [thyme new](/cli/new): Create a new task inside a Thyme project, scaffolded with a defineTask template plus local args, storage, and env files.
- [thyme run](/cli/run): Evaluate tasks locally in Deno, preview returned calls, exercise callbacks, and persist local storage.
- [thyme list](/cli/list): List the tasks discovered in the current Thyme project.
- [thyme login](/cli/login): Authenticate to a Flow deployment with a browser, pairing code, or existing API key.
- [thyme logout](/cli/logout): Clear a standard token or locally stored workspace management credential.
- [thyme upload](/cli/upload): Publish immutable Flow function releases with argument metadata and optional permission manifests.
- [thyme api-url](/cli/api-url): Print the API URL the thyme CLI will use and where that value comes from.
- [Verify Roles Profiles](/cli/verify): Independently check a Roles profile signature request or its deployed on-chain configuration.
- [Management Commands](/cli/management): Complete CLI reference for Flow projects, releases, executables, runs, profiles, secrets, webhooks, usage, and raw API requests.
- [CI & Non-Interactive Use](/cli/ci): Run every thyme CLI command from a pipeline, container, or coding agent — no TTY, no prompts, and a clear error naming the flag when a value is missing.
- [Configuration and Environment](/cli/configuration): CLI credential and API URL precedence, environment loading, project detection, and per-task files.
- [SDK Overview](/sdk/): The complete @thyme-labs/sdk 0.8 API for authoring Thyme Flow tasks and integrating its runtime.
- [defineTask](/sdk/define-task): Runtime argument validation, TypeScript inference, and optional lifecycle callbacks for Thyme Flow tasks.
- [ThymeContext (ctx)](/sdk/context): The single context object passed to a task's run handler — account, args, client, logger, secrets, and storage.
- [z (zodExtended) & schemas](/sdk/zod): The Zod namespace exported by the SDK, including z.address() for EVM addresses, and how schemas map to args.
- [Task Result Types](/sdk/results): TaskResult, SuccessResult, FailResult, and Call — the descriptors your run handler returns.
- [Lifecycle Callbacks](/sdk/lifecycle): Handle skips, task errors, confirmed execution, and submission failures with typed callbacks.
- [Function Permissions](/sdk/permissions): Declare the target addresses and function selectors a Flow release may call using permissions.json.
- [Logger](/sdk/logger): The captured Logger on ctx.logger — createLogger, LogEntry, and how output reaches the Console.
- [Storage & JSON Types](/sdk/json-types): JsonValue and JsonObject — the types behind ctx.storage and the rules for mutating persistent state.
- [Archive Utilities](/sdk/archive): Package and read source, bundles, and permission manifests with SDK archive utilities.
- [Runtime Integrations](/sdk/runtime): SDK subpath exports, source-schema extraction, and the shared cloud task runner protocol.
- [SDK and CLI Migration](/sdk/migration): Upgrade older Flow tasks to SDK 0.8.0 and CLI 0.10.0 with current arguments, callbacks, accounts, and permissions.
- [Build Your First Contract Task](/tutorials/first-task): Walk from a working local task to a scoped, observable contract update.
- [Test Tasks Locally](/tutorials/local-testing): Exercise arguments, state, secrets, simulation, and callbacks before a cloud run.
- [Persist State Across Runs](/tutorials/storage-state): Store compact checkpoints and separate observation from confirmed transaction state.
- [Schedule an Executable](/tutorials/scheduling): Choose a cadence, validate run outcomes, and manage recurring and on-demand invocations.
- [Choose a Gas Strategy](/tutorials/gas-strategy): Select sponsorship for scoped Safe profiles and fund any remaining legacy wallet-paid automation.
- [Release Management](/tutorials/release-management): Upload immutable versions, stage executable switches, roll back, and deprecate older releases.
- [Thyme Lift](/lift/): Policy-controlled gas sponsorship and ERC-4337 bundling for supported Safe accounts.
- [Connect to Lift](/lift/quickstart): Connect an existing supported Safe to the Sepolia bundler and paymaster endpoint.
- [Lift Policies and Keys](/lift/policies): Scope gas sponsorship to explicit senders, chains, contracts, selectors, and budgets.
- [Lift API Reference](/lift/api): JSON-RPC methods, UserOperation fields, sponsorship context, errors, and limits.
- [Lift Operations and Billing](/lift/operations): Understand reservations, UserOperation status, gas settlement, retries, and finality.
- [Lift with Flow](/lift/flow): How Flow Roles profiles use managed Lift policies and connect executions to gas settlement.
- [Thyme Gate](/gate/): Blockchain RPC endpoints, project API keys, and compute-unit usage for your applications.
- [Gate Quickstart](/gate/quickstart): Create an RPC key, select a network, and connect a server-side viem public client.
- [Gate Endpoints and Requests](/gate/endpoints): Discover current chains, authenticate execution requests, and understand RPC compatibility.
- [Gate API Keys](/gate/keys): Create, rotate, and revoke RPC keys scoped to a workspace and project.
- [Gate Usage and Billing](/gate/usage): Understand RPC compute units, billing-cycle estimates, request analytics, and plan limits.
- [Gate Troubleshooting](/gate/troubleshooting): Diagnose endpoint discovery, authentication, network mismatches, RPC failures, and usage discrepancies.
- [Thyme Atlas](/atlas/): Managed subgraph indexing on Graph Node. Deploy standard Graph CLI subgraphs and query them over authenticated GraphQL.
- [Atlas Quickstart](/atlas/quickstart): Deploy a subgraph to Atlas with Graph CLI, promote the release, and send a first authenticated GraphQL query.
- [Atlas Networks and Manifest Support](/atlas/networks): Supported network names and aliases, spec and API versions, data source kinds, history pruning, and size limits for Atlas subgraphs.
- [Atlas Queries, Keys and Limits](/atlas/queries): Query URLs, query and deployment keys, origin and IP key policies, rate and concurrency limits, GraphQL limits, errors, and plan allowances for Atlas.
- [Thyme Developer Docs](/index): Build and operate on-chain automation with Thyme Flow, the SDK and CLI, Lift gas sponsorship, and Gate RPC, and index subgraphs with Atlas.
- [Chains](/api/reference/chains)
- [Executables](/api/reference/executables)
- [Executions](/api/reference/executions)
- [Functions](/api/reference/functions)
- [Profiles](/api/reference/profiles)
- [Projects](/api/reference/projects)
- [Secrets](/api/reference/secrets)
- [Usage](/api/reference/usage)
- [Webhooks](/api/reference/webhooks)