Machine setup
Get your computer ready when a task needs a tool that's missing, stopped or signed out: what Ysra proposes, what it shows first, and what it never does.
On this page
Machine setup is what happens when a step is blocked by something on your computer: a tool that isn’t installed, isn’t running or isn’t signed in. Ysra pauses the task and proposes exactly one thing, in a card, with the exact command. Node.js, Python and Git are handled differently; see Install tools with your OK.
The rule#
Only what the card shows runs, and only after you agree. Auto mode never skips this card.
The setup card#
What would run, and what else it would change.
| Situation | Card | Answers |
|---|---|---|
| A tool isn’t installed | Install Go? | Go ahead · Not now |
| A tool is installed but not running | Start Docker? | Go ahead · Not now |
| A tool isn’t signed in | Sign in to … (for example Sign in to your hosting provider's command-line tool) | I’ve done it · Show me how |
The card shows the exact command and ends “Only what’s shown above runs. Auto mode never skips this.”
Side effects, before you agree#
If the step would change anything else, the card says so first:
This also upgrades: openssl@3, ca-certificates (shared with other apps)
It also installs: …
Warning
Read that line before Go ahead: upgraded packages are shared with other apps on your computer.
What happens after#
| You choose | What happens |
|---|---|
| Go ahead | The command runs; Ysra checks the tool really works, then the task continues from where it paused |
| Not now | Ysra carries on without it where it can |
| Show me how | The steps to sign in yourself (“Passwords are never asked for or typed for you.”); do them, then I’ve done it |
What Ysra does, and what stays with you#
| Ysra can, with your OK | Ysra never does |
|---|---|
| Install with your package manager (Homebrew, winget, Scoop) | Use sudo |
| Download an official build and verify its checksum | Run an installer that needs your password |
| Start an app or a service | Remove or uninstall anything |
| Sign in for you, or handle your passwords |
Related#
- Install tools with your OK: Node.js, Python and Git.
- Docker per session: allowing Docker once it runs.
- Approvals and auto mode: everything else Ysra asks first.
