fusion-timeline

name: fusion-timeline description: Read, navigate, and modify the Fusion 360 parametric timeline. Use when the user asks to list features, roll back/forward, suppress/unsuppress features, delete features, reorder timeline items, edit feature parameters, check feature health, create timeline groups, or analyze feature dependencies.

Fusion 360 Parametric Timeline

Full control of the Fusion 360 timeline via tools/fusion-timeline. The timeline is the parametric history — every sketch, feature, and operation is an ordered item. Rolling the marker back hides features; rolling forward reveals them.

Quick reference

tools/fusion-timeline list                  # all items + marker position
tools/fusion-timeline marker                # where is the marker?
tools/fusion-timeline item Extrude1         # detail for one feature
tools/fusion-timeline health                # any broken features?

Listing the timeline

# Full listing (all items with index, name, type, suppressed, health)
tools/fusion-timeline list

# Active features only (skip suppressed)
tools/fusion-timeline list --active

# Paginate (useful for large timelines)
tools/fusion-timeline list --start 10 --limit 20

List output fields

Inspecting a single item

Get rich details including parameters, affected bodies, and source sketch.

# By name
tools/fusion-timeline item Extrude1

# By index
tools/fusion-timeline item --index 3

Item detail fields

Includes all list fields plus:

• affected_bodies — bodies created/modified by this feature
• source_sketch — sketch that was used as the profile source
• parameters — editable parameters with values and expressions
• related_parameters — model parameters that reference this feature

Searching the timeline

# Find features by name
tools/fusion-timeline search --query extrude

# Find by type
tools/fusion-timeline search --type Sketch

# Combine name + type filter
tools/fusion-timeline search --query base --type Extrude

Feature parameters

# Get all parameters for a feature
tools/fusion-timeline params Extrude1
tools/fusion-timeline params --index 3

Marker position

# Check where the marker is
tools/fusion-timeline marker
# Returns: marker position, at_end/at_beginning, last_feature, next_feature,
#          rolled_back_features count

# Quick count
tools/fusion-timeline count
# Returns: total, active, suppressed, marker

Feature health

Check for warnings and errors across the entire timeline.

tools/fusion-timeline health
# Returns: healthy/warning/error/suppressed counts, plus a list of issues

Navigating the timeline

Roll to a specific feature

# Roll to just before a feature (feature is hidden)
tools/fusion-timeline roll Extrude1

# Roll to just after a feature (feature is visible)
tools/fusion-timeline roll Extrude1 --after

# Roll by index
tools/fusion-timeline roll --index 5
tools/fusion-timeline roll --index 5 --after

Roll to start/end

# Show all features (marker at end)
tools/fusion-timeline roll-end

# Hide all features (marker at beginning)
tools/fusion-timeline roll-beginning

Rolling strategy

When you need to understand what the model looked like at a certain point:

# Roll back to before a feature
tools/fusion-timeline roll SketchPocket --after
# Now the model shows everything up to and including SketchPocket

# Take a screenshot at this state
tools/fusion-camera screenshot --view isometric

# Roll back to the end
tools/fusion-timeline roll-end

Modifying the timeline

Suppress / unsuppress

Suppressing a feature temporarily disables it without deleting it.

# Suppress one feature
tools/fusion-timeline suppress Fillet1

# Suppress multiple by name
tools/fusion-timeline suppress --names Fillet1,Chamfer1,Fillet2

# Suppress by index
tools/fusion-timeline suppress --index 7

# Suppress multiple by index
tools/fusion-timeline suppress --indices 5,7,9

# Unsuppress (same arguments)
tools/fusion-timeline unsuppress Fillet1
tools/fusion-timeline unsuppress --names Fillet1,Chamfer1

Delete

Permanently remove a feature. The feature's entity is deleted, which may cascade to dependent features.

tools/fusion-timeline delete Fillet1
tools/fusion-timeline delete --index 7

Reorder

Move a feature to a different position in the timeline.

# Move a feature to the beginning
tools/fusion-timeline move Fillet1 --to 0

# Move to a specific position
tools/fusion-timeline move Fillet1 --to 5

# By index
tools/fusion-timeline move --index 7 --to 3

Edit parameters

Change a feature's parameter value or expression.

# Set by expression (recommended — supports units and parameter references)
tools/fusion-timeline edit-param Extrude1 --param distance --expr "20 mm"
tools/fusion-timeline edit-param Extrude1 --param distance --expr "width / 2"

# Set by raw value (mm for lengths)
tools/fusion-timeline edit-param Extrude1 --param distance --value 25

# By index
tools/fusion-timeline edit-param --index 3 --param distance --expr "15 mm"

Rename

tools/fusion-timeline rename Extrude1 --new-name BaseExtrude
tools/fusion-timeline rename --index 3 --new-name TopChamfer

Undo / redo

# Delete the last unsuppressed feature
tools/fusion-timeline undo

# Unsuppress the last suppressed feature
tools/fusion-timeline redo

Timeline groups

Organize related features into collapsible groups.

# Create a group from items 0 through 3
tools/fusion-timeline group --start 0 --end 3

# Collapse a group (hide its children in the timeline)
tools/fusion-timeline collapse GroupName

# Expand a group
tools/fusion-timeline expand GroupName

Dependency analysis

Find what features feed into or depend on a given feature.

tools/fusion-timeline deps Extrude1
tools/fusion-timeline deps --index 3

Dependency output

{
  "feature": "Extrude1",
  "index": 2,
  "upstream": [
    {"index": 0, "name": "Sketch1", "relation": "source_sketch"}
  ],
  "downstream": [
    {"index": 4, "name": "Fillet1", "shared_bodies": ["Body1"]},
    {"index": 5, "name": "Chamfer1", "shared_bodies": ["Body1"]}
  ],
  "affected_bodies": ["Body1"],
  "source_sketch": "Sketch1"
}

Complete command reference

Query

Navigate

Modify

Groups

Analysis

Common patterns

"What features make up this model?"

tools/fusion-timeline list

"Something is broken"

tools/fusion-timeline health
# If issues found, inspect them:
tools/fusion-timeline item BrokenFeature
tools/fusion-timeline deps BrokenFeature

"Try the model without these fillets"

tools/fusion-timeline suppress --names Fillet1,Fillet2,Fillet3
# Check the result...
tools/fusion-camera screenshot --view isometric
# Restore them
tools/fusion-timeline unsuppress --names Fillet1,Fillet2,Fillet3

"Change the base extrude height"

tools/fusion-timeline params Extrude1
# See that "distance" is currently "10 mm"
tools/fusion-timeline edit-param Extrude1 --param distance --expr "18 mm"

"Organize the timeline"

# Group the base sketch + extrude together
tools/fusion-timeline group --start 0 --end 1
# Group all the edge treatments
tools/fusion-timeline group --start 5 --end 9
tools/fusion-timeline collapse Group2

"What depends on this sketch?"

tools/fusion-timeline deps Sketch1
# Shows all features downstream that use Sketch1 as their source

"Step through the build history"

tools/fusion-timeline roll-beginning
tools/fusion-timeline roll --index 0 --after
tools/fusion-camera screenshot --view isometric
tools/fusion-timeline roll --index 1 --after
tools/fusion-camera screenshot --view isometric
# ... continue stepping through
tools/fusion-timeline roll-end