CLI and MCP · For the terminal and AI tools

Every module from the terminal, and from your AI agent.

The `1machine` command comes with the app on macOS, Windows and Linux and runs on the same core as the window: status, diagnosis, cleaning, VMs, Share Screen, Devices, Chat and more, with `--json` on every command. `1machine mcp` serves the same core to an AI agent, and anything that changes the machine needs `confirm: true`.

Checked against 1MachineTool 1.7.0, 18 November 2026

A terminal running 1machine diagnose slow, which prints the problem, the evidence, the fix and the undo
The 1machine command line, on the same core as the app. Sample output.

What it does.

One core, three ways in
The window, the CLI and MCP all call the same methods, so a number in the terminal is the number in the app.
JSON on every command
Add `--json` and pipe the result into a script.
An MCP server for your agent
`1machine mcp` speaks the Model Context Protocol over stdio and offers more than 50 tools, from machine status to cleaning, scenes, VMs and Chat.
Changes need a yes
Read-only tools are marked as such. Every tool that changes the machine refuses to run without `confirm: true`.
Diagnosis without AI
`1machine diagnose` answers slow, hot, battery, disk, sleep, wifi and woke from rules on this machine. No AI is involved.
Machines without a desktop
`1machine devices serve` and `1machine chat listen` run those services in the terminal, with no app window.

How you use it.

  1. Install 1MachineTool. The `1machine` command comes with it.
  2. Run `1machine status` to see how the machine is doing.
  3. Add `--json` when a script should read the answer.
  4. For an AI agent, add an MCP server whose command is `1machine mcp`.

From the terminal

1machine status
How the machine is doing right now.
1machine diagnose slow
Ask why: slow, hot, battery, disk, sleep, wifi or woke.
1machine hogs --by memory
Which apps are using the most CPU, memory, energy or network.
1machine awake 2h
Keep the machine awake while the command runs.
1machine mcp
Serve the core to an AI agent over stdio.

Free and Pro.

Free

Everything Free does in the app, within the same daily limits. The CLI and MCP meet the same gates as the window.

Pro

Everything Pro does, from the terminal: for example `1machine sync`, `1machine dns --set` and `1machine report --email`.

$29 once for one computer, $59 for three, $89 for five

On your computer.

What it doesn’t do.

  • The MCP server runs over stdio on the machine it controls. It is not a network service.
  • On a Mac, the charge limit, lid-closed mode and scheduled Low Power Mode need the privileged helper, from the terminal as in the app.
  • An agent gets the facts and the tools. It still needs your yes, as `confirm: true`, for every change.

Questions.

Does 1MachineTool have an MCP server?

Yes. `1machine mcp` serves more than 50 tools over stdio: status, diagnosis, cleaning, battery, network, VMs, scenes, Devices, Chat and more. Add it to your AI tool as an MCP server with that command.

Can an AI agent delete my files through it?

No tool deletes outright. Cleaning moves items to quarantine, where they can be restored for 30 days, and it refuses to run unless the call carries `confirm: true`.

Does the diagnosis send anything to an AI?

No. `1machine diagnose` and the MCP `diagnose` tool answer from rules on your machine. Bring-your-own AI in the app is separate and off by default.

How do I get JSON out of it?

Add `--json` to any `1machine` command, for example `1machine status --json`.

Keep reading.

Questions it answers

Everything your computer should have come with.