What beta means

• Features change between versions.
• Some things will break.
• Generated jobs and checks may contain errors.

Install updates when they arrive.

Checks and AI advice

• Generated G-code is a candidate program provided as is for your review. A passed computer check means only that the reported check passed for the supplied data; it does not establish that the program is correct or safe to run.
• An AI assistant's assessment can be wrong and is not a guarantee of correctness, safety or a successful cut.
• You must review the complete program and verify the actual machine, controller, units, zero, stock, cutter, workholding and clearances before deciding whether it is safe to run. Do not run it if you cannot verify the setup.
• Starting, resuming, homing or unlocking can cause machine movement, injury or damage. On-screen Stop is not an emergency stop; follow the machine manufacturer's safety instructions and use its physical emergency stop when needed.

If your assistant says a job passed, that is its own analysis. If a computer check passed, that check passed for the data it was given. Neither means the job is safe to run: that decision is yours.

See Safety for the checks built into the app and your part.

Give feedback

Tell your assistant "send feedback to anc" or "report a problem": it writes up what happened and sends it, with your OK, to the developer.

Or email contact@agenticnumericalcontrol.com.

If something moved unexpectedly or looks unsafe, stop the machine and email us straight away.

Download the app

A small app that sits in the tray: it links this computer, shows the machine and the job running, and has buttons to add the connector to your assistant.

Windows macOS (Apple silicon) macOS (Intel) Linux (AppImage) Linux (.deb)

On Windows, SmartScreen may say the publisher is unknown while the app isn't code-signed: choose More info, then Run anyway.

Windows

Run in PowerShell. Files go to %LOCALAPPDATA%\AgenticNumericalControl.

macOS and Linux

Run in Terminal. Files go to ~/Library/Application Support/AgenticNumericalControl on a Mac and ~/.local/share/agentic-numerical-control on Linux.

Already have Node.js

Fine for a quick try. The one-line installers are better for everyday use because they keep their own Node.js and update themselves.

CNCjs

The app has its own built-in copy of CNCjs, so there's nothing else to install or configure. If another program is using the machine's port, close it first.

Claude

1. Open Settings → Connectors → Add custom connector.
2. Name it Agentic Numerical Control and paste the address above.
3. Choose Sign in now and sign in with Google or GitHub.
4. It then works in Claude on the web, Claude Desktop and the Claude phone apps.

Codex

1. Run the first line in a terminal to add the connector.
2. Run the second to sign in. A browser page opens; sign in with Google or GitHub.
3. The Codex CLI, the Codex app and the IDE extension all use it.

ChatGPT beta

1. Go to chatgpt.com → Plugins, click + and choose Add custom MCP server.
2. Name it Agentic Numerical Control, paste the address above and set authentication to OAuth.
3. Click Create as a plugin and install it. In a chat, type @ and pick it.
4. Custom plugins depend on your ChatGPT plan and workspace settings.

How linking works

1. The installer (or anc setup) opens a page in your browser.
2. Sign in and press Link. On a computer without a browser, it shows a code to enter at the link page from any device.
3. The app finishes on its own and starts whenever you sign in to the computer.

More than one computer

You can link several. The one that connected most recently answers requests. You can see and unlink them on your account page.

Ways to open a job

• By file name: "Show me bracket.nc".
• From a list: "What jobs do I have?", then pick one.
• Pasted G-code: paste a program into the chat and ask to preview it.
• From CNCjs: load a file in CNCjs and the viewer follows it.

The viewer

Drag to orbit and scroll to zoom. Top and 3D switch views and Fit frames the job. The slider steps through the program line by line. Job shows the size, depth, cut and rapid lengths, feeds and spindle speed. Rapids, feeds and arcs each have their own colour.

This is a toolpath preview. It doesn't simulate material removal or check for collisions with clamps.

What your assistant asks you

• Units: STL and OBJ files don't say whether they're in millimetres or inches. STEP files do, and are read in millimetres.
• Material: aluminium, softwood, hardwood, MDF or plywood, acrylic or brass. Asked once and remembered.
• Stock: the size of the material. By default it's the part plus 10 mm in X and Y, as thick as the stock you said you have. In thicker stock the part can sit on the bottom, with the extra faced off the top.
• Zero: the front-left corner or the centre of the stock in X and Y. Z is always the top of the stock.
• Tools: from your tool library, with feed, plunge and spindle speed. Each operation can use its own tool; the job stops the spindle and pauses (M5 M0) at each change. Each tool's flutes and stick-out (how far it comes out of the collet) are asked once.

Operations

• Face: skims the top of the stock flat.
• Rough: clears material in flat layers, around the part or only inside it.
• Pocket: clears the flat areas below the top.
• Outline: cuts along the part's edges, layer by layer. Use it to cut the part out, with tabs to hold it in the stock.
• Contour: a 3D finishing pass over the surface, best with a ball end mill.
• Drill: drills round holes the size of the tool.
• Helical: bores round holes bigger than the tool with a spiral.

The model's round holes and flat areas are found for you, so drill, helical and pocket know where to cut. Tools can be flat or ball end mills, V-bits or drills. Output is G-code for GRBL and grblHAL.

The Make a job screen

Your assistant can open it for a model: the model in its stock, where zero is, whether it fits the machine, and the operations with their tools, feeds and speeds. Change anything there and press Generate.

In the cloud

Cloud jobs do the same: the same operations, models and tools. The cloud reads a model's holes and flat areas when you add it, and plans for the machine your computer last reported, or says the machine is unknown.

Your tool library

Your assistant can add, change and remove tools for you. It can also import tools exported from Kiri:Moto (.km) or Fusion (.json). Put the export in your Downloads folder and ask. Importing only adds tools, and only the ones you pick.

After it's made

The job is saved as a new file in the jobs folder and opens in the viewer like any other job. It isn't loaded into CNCjs or run until you do that yourself.

Each job comes with what to look out for, worst first, and what to change:

• Problems are likely to break a cutter or the machine: feeds too fast or slow for the cutter and material (chip load), cuts deeper than the flutes or the stick-out, passes too deep, fast straight plunges into metal, a job bigger than the machine, or cutting into the bed.
• Warnings are likely to spoil the part: material left where the cutter can't reach, holes and gaps narrower than it, round inside corners, a part that isn't cut free or comes loose with no tabs, a way up that reaches little of the part, or a size that suggests the wrong units.
• Notes are worth knowing: a long finishing pass, a flat cutter on curved surfaces, and anything assumed because it wasn't given.

None of them stops a job being made. Fix the problems before you run it.

Your assistant can simulate it: the stock is cut step by step on the Make a job screen, and anything left above the part or cut into it is pointed out.

The simulation covers the material only. Check a generated job in the viewer and run it in the air first. The app can't see your clamps, and G-code that previews fine isn't safe just because it previews fine.

The run bar

• Load into CNCjs sends the shown job to CNCjs without starting it.
• Start needs a second click to confirm. It only works when the status is live, the machine is idle and CNCjs has this job loaded.
• Pause, Resume and Stop control the running job. Unlock clears an alarm.

Watching a run

A marker shows the machine's reported position and the cursor follows the line being cut. Drag the slider to look ahead without affecting the machine, then press Return to live. Progress counts lines the controller has accepted, which runs a little ahead of cutting because GRBL buffers moves.

Built-in checks

• Starting a job always takes a deliberate second click in the viewer.
• Start is refused if the status isn't live, the machine isn't idle, or CNCjs has a different job loaded.
• If status updates stop during a run, the viewer says so instead of showing a frozen position as live.
• Jobs made from models are only saved. They're never loaded or run by themselves, and the CAM engine has no access to the machine.

Your part

• An on-screen stop is not an emergency stop. Keep the physical e-stop within reach.
• Check work offsets, tool length and clamping before starting. The preview can't see them.
• Run a new program in the air first, with the spindle off.

Called by your assistant

anc_show_jobopens viewer

Open the viewer for a file in the jobs folder (file) or for G-code text (gcode). Preview only.

anc_list_jobsread

List the G-code files in the jobs folder.

anc_list_portsread

List the serial ports CNCjs can see.

anc_connect_machinechanges state

Open the controller's serial port in CNCjs (port, baudrate, controller).

anc_disconnect_machinechanges state

Close the serial port.

anc_send_to_cncjschanges state

Load the shown job into CNCjs without starting it.

anc_job_controlmoves the machine

action is one of start, pause, resume, stop, feedhold, cyclestart, unlock, home or reset. Start is guarded as described in Safety.

Set-up and problems

anc_setupopens connection

Show the connection screen: whether the app is installed, linked and running, and what to do about anything missing. Works before the app is installed.

anc_report_problemopens report

Write up a problem report. You choose what to attach and press Send, or tell your assistant yes after it reads the report back.

Making jobs from models

anc_list_modelsread

List the STL, OBJ and STEP models in the jobs folder.

anc_inspect_modelread

A model's size in millimetres and in inches, to confirm its units. With units, also its round holes and flat areas.

anc_show_modelopens Make a job

Open the Make a job screen for a model, filled in with what your assistant knows (model, units, stock, origin, partSits, operations).

anc_cam_settingsread

The machine's travel and limits, the tool library and the operations available.

anc_set_machinechanges state

Tell ANC your machine: a common hobby machine by name, or its travel and spindle speeds.

anc_save_toolchanges state

Add a tool to the library, or change one.

anc_delete_toolchanges state

Remove a tool from the library.

anc_find_settingsread

Look for tool exports from Kiri:Moto and Fusion, and for CNCjs settings.

anc_import_toolschanges state

Add tools from a found export. Never replaces existing tools.

anc_generate_gcodechanges state

Make a job from a model (model, units, material, stock or stockThickness, origin, partSits, operations) and save it as a new file, with its problems, warnings and notes. Never loads or runs it.

anc_cam_statusread

Progress of a job being made.

anc_cam_cancelchanges state

Stop making a job.

anc_simulateopens Make a job

Cut the stock with a generated job and compare what's left with the model. Never moves the machine.

Called by the viewer

anc_snapshotread

Job identity, machine state and progress, polled while the viewer is open.

anc_get_toolpathread

Precomputed toolpath geometry, as a link to download it in one go.

anc_get_linesread

Program text for the line slider.

anc setup

Link the computer if needed, then start the app now and at every sign-in.

anc status

Show the link, the jobs folder, the data folder and the log file.

anc unlink

Stop starting at sign-in and remove this computer's link.

anc start

Run in the foreground. This is what the sign-in entry runs, and it checks for updates first.

anc stdio

Serve the tools over stdio for a local Claude Desktop or Claude Code setup.

Your account page

On your account page you can see each linked computer and whether it's online, unlink computers and disconnect assistants. You can also download everything the service holds about you as one file, or delete your account, which unlinks your computers and disconnects your assistants too.

What goes where

• Jobs you make on your own computer stay there. We don't copy your job folder or its G-code files to the cloud. A job passes through the service only when your assistant asks to show or run it.
• So you can check on your jobs from your phone, or while your computer is off, your computer sends a preview of each job it opens or makes: the toolpath, program lines and job check. Previews are kept for 30 days after the job was last opened. Run anc previews off on a computer to stop it sending them. The service also remembers how your machine was last reported (running, paused, how far through), so it can tell you if your computer drops off mid-run.
• When you add a file to the cloud (a 3D model or a G-code file), or ask for G-code to be made in the cloud, the file and what is made from it (the G-code and its preview) are stored privately for your account. Only you can open them, through your account or an assistant you've connected.
• We keep each cloud file for 30 days after you last use it (7 days if you're trying it as a guest), then delete it. A short record that the job happened stays, so your allowance is counted correctly. Deleting your account deletes your cloud files straight away.
• Cloud processing runs on Modal, and cloud files are stored in Cloudflare R2. Neither can start your machine: a cloud job is only ever downloaded by you or copied to your computer, where you review and start it yourself.
• Payments for the paid plan are handled by Stripe, which is the seller of record and keeps the payment details. We keep only your plan and its billing period.
• Your computer connects out over an encrypted connection, so no ports are opened.
• The public connector does not keep a history of tool inputs or replies for debugging. Older diagnostic records, if any, remain available in your data download until you delete your account. A separate developer-only connector can record explicitly scoped, short-lived traces containing tool names, input types and sizes, timing and outcomes. It does not record input values, response text, file contents or conversation history.
• A problem-report draft contains the issue you ask your assistant to write up. Drafts expire after 24 hours and can be cancelled. Optional diagnostics, named files and contact details start unselected; selecting an attachment collects it for review. A report is sent to ANC support only when you press Send or explicitly agree to the write-up and selected attachments. Reports are kept for 180 days for support follow-up, and go when you delete your account. Attaching computer diagnostics requires an app version that supports collecting only selected sections.

Contact

Email contact@agenticnumericalcontrol.com. Include what you were trying to do, what happened and any exact error message. Do not send passwords, sign-in codes or access tokens.

Report a problem from your assistant

Ask your assistant to report the problem. It prepares a draft that you can review. Optional details and files start unselected and are collected only after you select them. Nothing is sent to support until you press Send or explicitly agree to send the reviewed report.

If sign-in or the connector is not working, use the email address above. See Troubleshooting for common problems and Account and privacy for your data controls.

Your files and account

Use the service with files you have the right to process. Keep your account secure and link only computers you are authorised to use. Connecting an assistant gives it access to the files and computers available through that account; disconnect it on your account page when you no longer want that access.

You keep your rights to your files. The service processes them to provide the features you request. Cloud files have a limited retention period: download files you want to keep. Account and privacy explains storage, retention, reports and deletion.

Machine operation

Generated G-code is a candidate program provided as is for your review. A passed computer check means only that the reported check passed for the supplied data; it does not establish that the program is correct or safe to run.

An AI assistant's assessment can be wrong and is not a guarantee of correctness, safety or a successful cut.

You must review the complete program and verify the actual machine, controller, units, zero, stock, cutter, workholding and clearances before deciding whether it is safe to run. Do not run it if you cannot verify the setup.

You are responsible for checking the model, units, stock, cutter, workholding, machine setup and complete program before running a job. A preview, plan check or material simulation cannot verify your physical setup or guarantee a safe or successful cut.

Generating G-code saves a job; it does not load or run it. Starting a machine job requires your confirmation in the viewer and a live, idle machine with that same program loaded. On-screen Stop is not an emergency stop. Use the machine's physical emergency stop when needed and follow its manufacturer's safety instructions.

Cloud plans and payments

The website and account page show your current plan, allowance and renewal information. Review the plan and price before choosing a paid subscription. Checkout, payment details and subscription billing are handled by Stripe. Manage or cancel a subscription through the billing controls on your account page.

Checking and previewing a job are separate from making a new cloud job. The service reports when a requested generation uses your allowance. Availability and processing time can vary; keep a copy of files you need.

Help and questions

Contact contact@agenticnumericalcontrol.com about the service or these terms. Nothing here removes consumer rights that apply to you under law.

"Your PC is offline"

Ask your assistant to check the connection. The connection screen shows whether the app is installed, linked and running, when the computer was last seen, and the line to paste to start it again. anc status on the computer says whether the app is running and shows the end of its log.

Something else isn't working

Ask your assistant to report the problem. It writes the report for you, and you choose what to send with it.

Sign-in loops or fails

Remove the connector and add it again, then sign in with the same account you used to link the computer.

The viewer says "No status"

CNCjs has lost contact with the controller. Check the USB cable and that the right port is connected.

Start is greyed out

The machine must be idle with a live status, and CNCjs must have this job loaded. Use Load into CNCjs first.