Skip to content

Temporal Agent CLI - examples for AI-native workflow debugging - #1

Open
moetemp wants to merge 57 commits into
moe/temporal-agent-clifrom
moe/temporal-agent-cli-examples
Open

moetemp wants to merge 57 commits into
moe/temporal-agent-clifrom
moe/temporal-agent-cli-examples

Conversation

@moetemp

@moetemp moetemp commented Jan 9, 2026

Copy link
Copy Markdown
Owner

This PR adds a collection of example applications demonstrating how AI agents can use Temporal's new debugging commands (temporal workflow failures, temporal workflow diagnose, etc.) to build and troubleshoot distributed systems.

What's included

Example applications:

  • agent-demo - Simple workflow demonstrating the debug loop pattern
  • debug-loop - Order processing workflow with intentional failure scenarios
  • ai-research-agent - Multi-step research workflow with parallel activities
  • ecommerce-nexus - Multi-namespace e-commerce system using Nexus for cross-namespace calls
  • ticketdrop - Ticket sales system with queue management and payment processing

Documentation:

  • Step-by-step plans for building each application with an AI assistant
  • LLM chat transcripts showing real debugging sessions
  • Demo scripts for showcasing AI-assisted debugging in presentations

Why this matters

These examples validate that the new CLI commands provide enough context for AI agents to:

  1. Identify failing workflows without manual investigation
  2. Trace through child workflows and Nexus operations to find root causes
  3. Generate visual diagrams (Mermaid) to understand workflow state
  4. Fix bugs based on structured error output

The ticketdrop-impl example includes a demo workload script and a pre-configured bug for live demonstrations of AI-assisted debugging.

moetemp pushed a commit that referenced this pull request Sep 30, 2026
## Related issues

Related to #[1104](temporalio#1104)

## What changed?

<!-- Describe what this PR does at a high level. -->
This adds a command-line option that configures the embedded UI server
to disable the news feed feature.

## Checklist

<!-- Your PR should satisfy all these requirements. However, feel free
to remove items that don't apply to the PR. Consider giving this
checklist to an AI agent before opening your PR. -->

## Manual tests

<!-- Edit the code samples below to provide setup and happy-path and
error-path testing instructions. -->

**Setup #1 (default case)**
```
temporal server start-dev
```

**Happy path #1 (default case)**
Open the Web UI and observe that the news fetch feature is enabled, as
it is by default. This is visible by way of a megaphone icon in the top
navigation.



**Setup two (feature disabled)**
```
temporal server start-dev --ui-disable-news-fetch
```

**Happy path two (feature disabled)**
Open the Web UI and observe that the news fetch feature is disabled,
since the environment variable is set to disable it, as described in the
documentation. This is evident by the megaphone icon being omitted from
the top navigation and the Web UI not making a request for the feed.

---------

Co-authored-by: alex.stanfield <13949480+chaptersix@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant