# Golem Schedule Agent TS

> Scheduling a future invocation on a TypeScript Golem agent. Use when asked to schedule, delay, or plan a future agent method invocation using golem agent invoke --trigger --schedule-at.

- Skill: `golemcloud/golem-schedule-agent-ts` (Agent Skill)
- Install (CLI): `npx skillmds@latest add golemcloud/golem-schedule-agent-ts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/golemcloud/golem-schedule-agent-ts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: golemcloud (https://skillmd.com/u/golemcloud)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/golemcloud/golem-schedule-agent-ts

---


# Scheduling a Future Agent Invocation

Both `golem` and `golem-cli` can be used — all commands below work with either binary.

## Usage

```shell
golem agent invoke --trigger --schedule-at <DATETIME> <AGENT_ID> <FUNCTION_NAME> [ARGUMENTS...]
```

The `--schedule-at` flag schedules the invocation to execute at a specific future time. It **requires** the `--trigger` flag because scheduled invocations are always fire-and-forget — the CLI returns immediately after the invocation is enqueued.

## DateTime Format

The `--schedule-at` value must be in **ISO 8601 / RFC 3339** format with a timezone:

```
2026-03-15T10:30:00Z          # UTC
2026-03-15T10:30:00+02:00     # With timezone offset
```

## Examples

### Schedule a method to run at a specific time

```shell
golem agent invoke --trigger --schedule-at 2026-03-15T10:30:00Z 'MyAgent()' runDailyReport
```

### Schedule with parameters

```shell
golem agent invoke --trigger --schedule-at 2026-04-01T00:00:00Z 'BatchProcessor("daily")' generateReport '"Q1-2026"'
```

### Schedule in a specific environment

```shell
golem agent invoke --trigger --schedule-at 2026-03-15T08:00:00Z 'production/NotificationAgent()' sendReminders
```

### Schedule with an idempotency key for deduplication

```shell
golem agent invoke --trigger --schedule-at 2026-03-15T10:30:00Z -i 'report-2026-03-15' 'ReportAgent()' generateDaily
```

## Available Options

| Option | Description |
|--------|-------------|
| `-t, --trigger` | **Required** with `--schedule-at`. Fire-and-forget mode |
| `--schedule-at <DATETIME>` | The time to execute the invocation (ISO 8601 / RFC 3339) |
| `-i, --idempotency-key <KEY>` | Set a specific idempotency key; use `"-"` for auto-generated |
| `--no-stream` | Disable live streaming of agent stdout/stderr/log |

## How It Works

1. The CLI sends the invocation request with the scheduled time to the Golem server
2. The server enqueues the invocation to execute at the specified time
3. The CLI returns immediately with the idempotency key
4. At the scheduled time, the Golem runtime executes the invocation

## Idempotency

Scheduled invocations use idempotency keys just like regular invocations. Providing the same idempotency key for a scheduled invocation ensures it is not executed more than once, even if the CLI command is retried.

## Auto-Deploy

If the agent's component has not been deployed yet and the CLI is run from an application directory, the command will automatically build and deploy the component before scheduling.

## Value Syntax

The agent ID parameters and method arguments use **TypeScript syntax**:

- Field names use `camelCase`
- Options: raw value or `undefined`
- Records: `{ fieldOne: 1, fieldTwo: "hello" }`
- Variants: `{ tag: "variant-name", value: 42 }`
- Tuples: `[1, "hello"]`

```shell
golem agent invoke --trigger --schedule-at 2026-03-15T10:30:00Z 'MyAgent("user-123")' runTask '{ priority: 1, retry: true }'
```