fusion-local-cam
Inspect, modify and regenerate CAM operations in local Autodesk Fusion desktop documents using the workspace bridge, after CAD validation. Use for offline CAM parameter changes, toolpath generation an
SKILL.mdskills/fusion-local-cam/SKILL.md
GitHubRead this project's AGENTS.md, SETUP.md and STATUS.md. The CAD workflow must pass before CAM begins; validate new parts before generating their toolpaths. The bridge executes adsk.cam on Fusion's main thread, enforces Work Offline mode and owns only new or locally imported unsaved documents. It never posts NC or saves to Autodesk cloud.
Use py -3 scripts/cad_client.py cam_inspect to inspect local setups, stock/WCS parameters, tool JSON, operation IDs and expressions. Supply JSON through --params-file to avoid shell quoting mistakes. Each mutation uses fresh session, revision and operation_id from inspection. Read cam_operations.py for the supported parameter allowlist. cam_update takes a parameters object mapping actual parameter names to unit-qualified expressions. Missing or uneditable parameters are rejected. Native checkpoints and before/after reports are written per request.
cam_generate returns a job ID; poll it using cam_job_status with {"job_id":"..."}. Serialize requests and keep the document/geometry unchanged until generation completes. Client timeout is not cancellation: inspect the original request/job instead of starting another generation. Job IDs expire when the add-in is restarted and belong to their original document session.
Require generation completion, has_toolpath, toolpath_valid, no reported errors and a nonempty cutting distance. Review warnings rather than ignoring them. In this installed build, numberOfCompleted can remain zero when isGenerationCompleted and toolpath checks succeed; do not use that counter alone as a failure criterion. Native archive export preserves the tested CAM setup and operation. Reopen it locally and re-inspect modified parameters. A later CAD change can invalidate the toolpath; check and regenerate it.
Use cam_capture with the same operation target for a Z-up isometric viewport showing the selected path and tool. Inspect the image with view_image; its visibility and a successful generation do not prove machine clearance or production readiness. CAM parameter lengths are cm, angles degrees and feeds mm/min; getMachiningTime rapid feed is cm/s. The WCS matrix is reported raw because its translation units must be established separately from ordinary parameter units.
For a repeatable test, run py -3 scripts/cam_acceptance.py LOCAL_FIXTURE_F3D using the successful CAD geometry fixture described in SETUP.md. cam_create_test_setup creates a disposable face-milling setup only on a one-root-body document with no existing setups. It discovers Fusion's newest installed local metric sample-tool JSON. If discovery fails, use the ignored local-fusion-config.json override described in SETUP.md. Sample feeds, spindle speed and stock values are software-test inputs, not machining recommendations.
Verified capability covers face-milling creation, supported expression edits, generation/regeneration, rollback, persistence and regeneration after CAD change. For additional strategies, stock/WCS modification, tool selection, collision simulation or posting, implement and validate the specific workflow before claiming support. A physical machining plan also needs the user's actual material, machine/controller, tools, workholding and tolerances; do not infer them from the acceptance fixture.
References: installed Api/Python/packages/adsk/cam.py, Autodesk CAM parameters, manufacturing API example. Check the installed API first because sample/API details vary by release.