A terminal browser for Autodesk Platform Services (APS) Manufacturing Data Model. Navigate your Fusion hubs, projects, folders, and designs from the command line.
Homebrew (macOS / Linux) — recommended
brew install schneik80/fusiondatacli/fusiondatacliOr download the latest binary for your platform from Releases.
macOS (Apple Silicon)
VERSION=$(curl -s https://api.github.com/repos/schneik80/FusionDataCLI/releases/latest | grep '"tag_name"' | cut -d'"' -f4 | tr -d v)
curl -L "https://github.com/schneik80/FusionDataCLI/releases/latest/download/FusionDataCLI-${VERSION}-darwin-arm64.tar.gz" | tar xz
sudo mv fusiondatacli /usr/local/bin/macOS (Intel)
VERSION=$(curl -s https://api.github.com/repos/schneik80/FusionDataCLI/releases/latest | grep '"tag_name"' | cut -d'"' -f4 | tr -d v)
curl -L "https://github.com/schneik80/FusionDataCLI/releases/latest/download/FusionDataCLI-${VERSION}-darwin-amd64.tar.gz" | tar xz
sudo mv fusiondatacli /usr/local/bin/Linux (amd64)
VERSION=$(curl -s https://api.github.com/repos/schneik80/FusionDataCLI/releases/latest | grep '"tag_name"' | cut -d'"' -f4 | tr -d v)
curl -L "https://github.com/schneik80/FusionDataCLI/releases/latest/download/FusionDataCLI-${VERSION}-linux-amd64.tar.gz" | tar xz
sudo mv fusiondatacli /usr/local/bin/Windows — download fusiondatacli-{version}-windows-amd64.zip from the Releases page and add the binary to your PATH.
fusiondatacliOn first run the app opens your browser for Autodesk sign-in. After authenticating, navigate with keyboard or mouse:
| Key | Action |
|---|---|
↑ ↓ / w s |
Move cursor |
→ ↵ / d |
Enter folder / open details |
← / a |
Go back |
h |
Switch hub (re-open the hub picker) |
u |
Open selected document in browser (only after details have loaded) |
o |
Open in Fusion desktop (via Fusion MCP) |
i |
Insert into active Fusion design (via Fusion MCP) |
shift+d |
Download STEP file for the selected design |
shift+p |
Pin / unpin the selected project, folder, or document |
p |
Open the pins overlay |
t |
Cycle color theme |
m |
Toggle mouse support on/off |
shift+a |
About / license |
r |
Refresh |
? |
Debug log |
q |
Quit |
Inside the pins overlay, Enter jumps to the pin's location, delete/backspace removes the pin, and o / i open or insert the pinned document directly into the running Fusion desktop client (document pins only — project and folder pins ignore those keys with a hint). The overlay stays open so multiple pins can be acted on in sequence; press p to close.
Selecting a design or drawing opens the details panel. The strip across the top exposes cross-references for that item:
| Key | Tab | Available on |
|---|---|---|
1 |
Details | All documents |
2 |
Uses — sub-components (designs) or source design (drawings) | DesignItem, DrawingItem |
3 |
Where Used — designs that reference this component | DesignItem only |
4 |
Drawings — drawings made from this design | DesignItem only |
↑ ↓ / w s (on a non-Details tab) |
Move the tab cursor | — |
Enter (on a non-Details tab) |
Show in Location — jump the Contents column to the highlighted row's project + folder + item | — |
| Double-click (on a non-Details tab) | Same as Enter | — |
Mouse support is enabled by default. Click items to select and navigate, use the scroll wheel to move through lists. Press m to toggle mouse on/off. The footer bar shows the current mouse state.
The header displays a breadcrumb trail showing your current location in the hierarchy: Hub > Project > Folder(s) > Document. Each segment is clickable — click the hub to open the hub-select overlay, click a project or folder to jump back to that level.
The o and i keys drive the running Fusion desktop client via its local MCP server (http://127.0.0.1:27182/mcp). o opens the selected document in a new Fusion window; i inserts it as an occurrence into the active design. Before sending the call, FusionDataCLI verifies that Fusion is on the same hub as the CLI (by matching the selected project against Fusion's active-hub project list) and refuses the call with a descriptive status message when the hubs differ.
The u key opens the selected document in your default browser using the item-level fusionWebUrl permalink returned by the APS Manufacturing Data Model GraphQL API. This URL is loaded as part of the details panel, so u only fires after the details panel has finished loading for the selected item — the key hint [u] web appears at the bottom of the details panel while it's actionable. Pressing u on a container (project/folder) or before the details panel has loaded is a no-op with a status-bar hint.
The earlier hand-constructed fallback URLs (https://autodesk360.com/g/projects/..., https://acc.autodesk.com/docs/files/projects/...) have been removed — those patterns are rejected by Autodesk's team web app with a raw JSON BROWSER_LOGIN_REQUIRED error on team hubs. Only the per-item permalink from the Data Model API is trusted now.
The full URL passed to the OS browser handler is shown in the status bar so it can be inspected or copied.
Press shift+d on a selected design (after the details panel has finished loading) to export it to STEP. The CLI requests a STEP derivative from the APS Manufacturing Data Model (componentVersion(...).derivatives(outputFormat: STEP, generate: true)), polls every two seconds until status is SUCCESS or FAILED, and then streams the signed-URL response to:
~/Downloads/<design-name>-<YYYYMMDD-HHMMSS>.stp
If the home directory cannot be determined the file is written to os.TempDir() instead. Filenames are sanitised to a safe whitelist (alphanumerics, dash, underscore, space, dot) so cross-platform paths always round-trip cleanly.
shift+d is only valid on DesignItem rows that have a tipRootComponentVersion — drawings (DrawingItem), configured designs (ConfiguredDesignItem), folders, and projects are not supported by the derivatives endpoint. Pressing shift+d on those rows is a no-op with a status-bar hint. A second shift+d press while a download is already in flight is also rejected so polls don't pile up.
If your Fusion hub is in EMEA or Australia, set the region before running:
APS_REGION=EMEA fusiondatacli # Europe, Middle East, Africa
APS_REGION=AUS fusiondatacli # AustraliaPress → on any design to open the details panel. It shows:
- File size and current version number
- Created and last modified date and user
- Component metadata: part number, description, material, milestone flag
- Full version history with save comments
- An Autodesk account with access to at least one Fusion Team hub
- macOS 12+, Linux, or Windows 10+
- Port
7879available locally during sign-in (used for the OAuth callback)
Requires Go 1.22+.
git clone https://github.com/schneik80/FusionDataCLI
cd FusionDataCLIWith your own APS app (register a public client at aps.autodesk.com/myapps, redirect URI http://localhost:7879/callback, scope data:read):
make build CLIENT_ID=your-client-idOr store your client ID in a git-ignored file:
echo "your-client-id" > .aps-client-id
make buildLocal dev without an embedded client ID (supply via env var at runtime):
make dev
APS_CLIENT_ID=your-client-id ./fusiondatacli| Doc | What it covers |
|---|---|
docs/navigation.md |
Three-column browser, details-pane tabs, Show in Location, mouse, themes |
docs/api.md |
APS Manufacturing Data Model GraphQL queries, retry behaviour, debug logging |
docs/authentication.md |
OAuth PKCE flow, token storage, refresh |
docs/architecture.md |
C4 diagrams, package layout, data flow, performance, resilience |
docs/debugging.md |
Reporting a bug — what to capture and how to file it |
docs/testing.md |
Test strategy and how to run / extend the suite |
docs/development.md |
Building from source, release pipeline, dependencies |
make check # go vet ./... + go test -race ./...make check runs the same vet + race-tested suite that CI runs on every pull request and push to main (.github/workflows/test.yml). The full suite finishes in under five seconds. See docs/testing.md for the test architecture.
GNU General Public License v3.0 — © Kevin Schneider