Skip to content
tc

Change Management

Versions

Section titled “Versions”

To find the versions of topologies created in a sandbox

Terminal window
tc snapshot -s stable -e qa
| namespace | kind   | sandbox | version | git_version | frozen | tc_version | updated_at          |
|-----------|--------|---------|---------|-------------|--------|------------|---------------------|
| topo-1    | stepfn | stable  | 0.1.2   | 0.1.2       |        | 0.9.17     | 09:10:2025-23:44:28 |
| topo-2    | stepfn | stable  | 0.4.3   | 0.4.3       |        | 0.9.21     | 09:23:2025-15:44:02 |
| topo-3    | stepfn | stable  | 0.0.6   | 0.0.6       |        | 0.9.17     | 09:10:2025-23:44:28 |
| topo-4    | stepfn | stable  | 0.0.122 | 0.0.122     |        | 0.9.24     | 10:02:2025-16:41:02 |
| topo-5    | stepfn | stable  | 0.13.16 | 0.13.16     |        | 0.9.17     | 09:11:2025-00:46:05 |
| topo-6    | stepfn | stable  | 0.2.148 | 0.2.147     |        | 0.9.26     | 10:02:2025-20:34:09 |
| topo-7    | stepfn | stable  | 0.0.11  | 0.0.11      |        | 0.9.17     | 09:10:2025-23:44:27 |
| topo-8    | stepfn | stable  | 0.1.27  | 0.1.27      |        | 0.9.17     | 09:10:2025-23:44:28 |

Changes between versions or envs

Section titled “Changes between versions or envs”

To see the changes between two environments or profiles

Terminal window
cd topology-dir
tc diff -s stable --between qa..poc
Finding diff between 0.54.0..0.55.1
Modified functions:
  - processor
  - transformer




Changelog:
- [XYZ-HB] (patch) Dummy PR (#10847)
- [QA-2077] (patch) Fix response schema (#10839)

Transposed view of envs

Section titled “Transposed view of envs”

To find transposed versions between environments

Terminal window
tc snapshot -s stable -e qa,staging
 Topology                       | qa       | poc
--------------------------------+----------+----------
 topo-1                         | 0.4.3    | 0.4.3
 topo-2                         | 0.13.16  | 0.13.16
 topo-3                         | 0.0.22   | 0.0.17
 topo-4                         | 0.1.20   | 0.1.18
 topo-5                         | 0.1.6    | 0.1.4

Changelog

Section titled “Changelog”

To see the changelog of a specific topology

cd topology-dir
tc changelog


AI-123 Another command
AI-456 Thing got added


# or


tc changelog --between 0.8.1..0.8.6

To search for a specific text in all changelogs

cd root-topology-dir
tc changelog --search AI-1234


=> topology-name, version