temporalio / temporal
Temporal service
github.com/temporalio/temporalIndexed at a2de6d8Up to date with upstream
About this codebase
This codebase combines multiple evidence views of “what to do next” and “how to reason about it”: it keeps a runtime execution path for executable Workflows and related tasks, and it also maintains deeper internal representations (notably CHASM) for composing and validating work. Together, these views let the system both execute tasks safely and keep consistent behavior across workflow chains and operational edge cases—so the server can handle real-world churn while preserving correctness.
Written by gpt-5.4-nano from the index
3,156 files and 40,520 symbols in 17 modules, led by Go (2,689 files) and Shell (26).
Start reading
- Knowledge graph3,156 files and how they depend on each other.
- History Replication OrchestratorDocumentationDocumentation for service/history/replication, written by gpt-5.4-nano.
- Add batch workflow refresh tasks via Admin API and Batched System Worker activityDecisionProposed decision, from a pull request.
Code health
This codebase scores 6.7 out of 10 for code health, which we rate fair. It also scores maintainability 7.1 and static performance 9.9 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 300 of 3,156 files are git hotspots, and they average 4.8 — which is where the fixes pay off most.
On the leaderboards:#3 of 3 Workflow orchestrators#12 of 19 Go repos
Do next
2 things worth doing in the week to Oct 6, the last indexed commit, 2 of them now.
Now
- Critical
Simplify
callScalerinservice/matching/scale_manager.gowhile the change is fresh1 commit in the last 7 days added or worsened 1 critical or high finding here, still open. Fixing now costs less than after the next change.
- serious findings
- 1
- critical
- 1
- latest commit
- Dynamic partitioning: add scale manager enabled setting (#12138)
Small effort - High
Tidy 2 functions you changed in
tools/tdbg/scheduleaudit/analyzer.gothis week1 commit in the last 7 days added or worsened 2 critical or high findings here, still open. Fixing now costs less than after the next change.
- serious findings
- 2
- critical
- 0
- latest commit
- Add tdbg schedule audit command (#10929)
Small effort
Improve what Repowise can see
Add a test coverage report
Without one, Repowise cannot tell tested code from untested code, so every test-related action says “unknown”.
- line coverage
- Unknown, no report
Small effort
Use temporalio/temporal in your agent
Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.
https://api.repowise.dev/mcp/temporalio/temporalOne command, run anywhere. Adds the server to your local Claude Code config.
Docsclaude mcp add --transport http repowise https://api.repowise.dev/mcp/temporalio/temporal \ --header "Authorization: Bearer rw_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
This repo is public, so anyone with a Repowise account and an API key can connect.
Try asking
- get_risk(["tools/tdbg/scheduleaudit/analyzer.go"])
- get_answer("how is temporal put together?")
- get_why("why is temporal structured this way?")
Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.
Go deeper
- OverviewEverything the index found, what changed this week, commits and decisions.
- DocumentationModule-by-module documentation, 4,306 pages, 81 written by a model.
- ArchitectureDependency graph, layers and third-party dependencies.
- Code healthEvery file's score, the findings behind it, tests and refactoring plans.
- CommitsEach commit's effect on code health, with agent provenance.
- ContributorsWho owns what, and where one person holds most of the knowledge.
- DecisionsArchitectural decisions mined from commits and pull requests.
- Ask this codebaseSign inGrounded answers over the indexed code.
Maintain this repo? Claim the page
Sign in with GitHub and we check that you are an admin or maintainer of temporalio/temporal. Then add a badge to the README that links readers here.
Use this repo from Claude or ChatGPT
Add this URL as a custom connector and sign in with repowise when asked. No API key to copy.
https://api.repowise.dev/mcp/temporalio/temporalFor maintainers
Add a badge to your README
Every badge is public, cached, and updates on its own after every index. Nothing to install.
Repowise badge
Links to this page, with no score on it. Adding it also re-indexes the repo every week.
[](https://repowise.dev/repo/temporalio/temporal?src=badge_wiki)Code health badge
The repo's health score out of 10, from the latest index.
[](https://repowise.dev/repo/temporalio/temporal?src=badge_health)Code health card
A larger card with the score, its change since the last index, and when it was measured. The HTML version follows the reader's light or dark theme.
[](https://repowise.dev/repo/temporalio/temporal?src=badge_card)How temporalio/temporal works
Temporal service This page is a map of the temporalio/temporal repository, written primarily in Go, rebuilt from the source each time it is indexed. Repowise parses every symbol, computes a dependency graph, scores per-file code health from complexity, duplication, test coverage and churn, mines git history for hotspots and ownership, and lifts the architectural decisions into documentation you can read here or query through MCP.
The codebase has 3,156 files and 40,520 symbols in 17 modules, led by Go, Shell and Makefile. Code health is 6.7 out of 10, rated fair.
Use the links above to open each view, or connect this repository to your agent for grounded answers inside Claude, Cursor, Codex or VS Code.