Overview
Wysebee Agent for Windows is a small app in the Windows notification area. You pair it with Wysebee, which creates a new agent for this PC. That agent, and only that agent, can then:
- run the programs you set up in Wysebee, once you allow each one on the PC;
- run the scripts your skills declare, once you allow each skill on the PC;
- find, read and, where you allow it, write files in the folders you pick on the PC;
- and, only if you switch them on, run any program, control the screen, work as a developer, or use Android phones.
The app runs no AI model. Your AI app (Claude, ChatGPT, or the Wysebee website) does the thinking; Wysebee Agent carries out only what you allowed here. See the product page for a shorter tour.
Requirements
- PC
- 64-bit (x64); Windows on Arm runs it under emulation
- Windows
- Windows 10 or 11, with the Microsoft Edge WebView2 Runtime (part of Windows 11; Windows Update brings it to Windows 10)
- Account
- A free Wysebee account, at app.wysebee.com
- Distribution
- A per-user installer from this site, outside the Microsoft Store; no administrator rights needed
Install
- Download wysebee-agent-win-v0.2.0-setup.exe.
- Run it. It installs for your Windows account only, so it asks for no administrator password. Leave Start Wysebee Agent when I sign in ticked to have it running after a restart.
- At the end, Start Wysebee Agent opens it. Later, find it in the Start menu.
- A bee appears in the notification area by the clock (Windows may tuck it under the ^) and the Wysebee Agent window opens. Click the bee to bring the window back.
The bee's right-click menu has Open, Pause / Resume and Quit. Closing the window only hides it. Start at sign-in under Settings turns starting with Windows on or off later.
To update, download the new installer and run it: it closes the running app and replaces it in place. Your pairing, approvals and folders are kept.
Pair your PC
- In the Wysebee Agent window, type a name for the new agent (1 to 60 characters, such as Office PC) and click Pair. The window shows a code like
XXXX-XXXX; the copy button copies it. - Sign in at app.wysebee.com, open Devices, choose Pair a device → Pair a Windows PC and type the code.
- Wysebee creates the agent under that name, and the PC's window shows it as connected, with the tabs Programs, Folders and Settings.
Pairing always creates a new agent. If the name already belongs to one of your Windows agents that has no PC now (after an unpair, or a new PC), Wysebee offers to Reconnect to it instead. The agent keeps its tools, but nothing runs on this PC until you allow it here again.
The agent itself runs in Wysebee Cloud, so this PC needs nothing but Wysebee Agent. Talk to it from the Wysebee website, or from Claude or ChatGPT through the Wysebee Assistant connector.
Programs
A program tool is something you define once in Wysebee: which program runs, with which fixed arguments, and which blanks the AI fills in.
- In Wysebee, open the PC's agent, go to its Tools tab and add Run local program from the Tool library.
- Give it a Tool name (like
make_report) and say What it does: the AI reads this to know when to use it. - Set the Program: a full path, or a program's name (like
gitorpython). It must be an.exeor.com. - Add Arguments, each one either Fixed text or a blank Wysebee fills in, with a name and what should go there.
- On the PC, the program appears under Programs, waiting, with its whole command line. Read it and click Allow.
For example, a convert_document tool with the program pandoc and three arguments: a blank input, the fixed text -o and a blank output. The PC shows, and runs, exactly:
C:\Users\you\AppData\Local\Pandoc\pandoc.exe {input} -o {output}The rules a program runs by
- The AI sends only the tool's name and the blanks' values. What runs is the copy you allowed on this PC, with the program's full path as found when you clicked Allow.
- Never a shell, and so never a
.bator.cmdfile: each value is passed as one argument, whatever it holds.a b & del *is just that text. - No input, no console window, run in your home folder, stopped after 60 seconds; output and errors each cut at 20,000 characters.
- Change the program, its arguments or a blank's name in Wysebee and it waits for Allow again; the description alone does not count. Remove it in Wysebee and its approval goes too.
- A bare name is looked up as itself,
name.exeandname.comin each folder of the PATH, plus your app execution aliases (%LOCALAPPDATA%\Microsoft\WindowsApps) and Scoop'sshims. If the file is gone later, the program is reported asmissing-programuntil you allow it again.
Skills
A skill is a folder of instructions (SKILL.md) and files you give an agent in Wysebee. Its scripts run only here, on the PC paired with the agent.
- Give the PC's agent a skill in Wysebee (its Skills tab).
- Wysebee Agent downloads the skill's files at once and checks each one against its SHA-256. It shows under Skills, waiting, with the scripts its
SKILL.mddeclares (each command line) and its files. Nothing of it runs yet. - Click Allow. The files go into the skill's folder on this PC and each script's program is found.
A skill declares its scripts in the front matter of its SKILL.md:
---
name: weekly-report
description: Builds the weekly sales report from the CSV exports.
scripts:
- name: build
command: python scripts/build_report.py
description: Builds the report; pass the week, like 2026-W46.
---
Instructions for the agent go here.- Only declared scripts run: the script's command, then the call's arguments (at most 30), each one argument, in the skill's folder. Same 60 seconds, no input, output cut.
- A script inside the skill must stay inside its folder; a link or .. that leads out is refused, at Allow and again at every run.
- Change any file in Wysebee and the new version is downloaded at once and waits for Allow. Until then the copy you allowed stays exactly as it was.
- Show in File Explorer opens the skill's folder. Files you put there yourself (a
.envthe scripts read, say) stay on this PC, are never sent and are kept when you allow a new version.
Folders
Folders are picked on the PC, never typed in Wysebee: under Folders, click Add a folder… and choose one in Windows' own folder picker. Give it a name (the folder's own by default), choose Read only or Read and write, and say what it holds if you like: the AI reads that to know which folder to use.
The agent sees it at once and can find, list, read and (in a read-and-write folder) write files there. There is nothing to approve: you chose each folder yourself. Allow writing / Make read only, Edit and Remove… change it later.
- Text, Word (.docx), Excel (.xlsx, .xlsm, .xls, .ods) and PDF are read as text.
- A picture (.png, .jpg, .gif, .webp) is shown to you in Wysebee and never to the AI.
- Paths are relative to the folder; a drive (C:), absolute paths, .. and links or junctions that lead out are refused. Writing needs a read-and-write folder, whatever the call says.
- Up to 20 folders. Files read up to 50 MB (a picture 10 MB); a search looks at up to 50,000 entries and skips .git, node_modules, .Trash and __pycache__; every answer is cut at 50,000 characters.
Optional abilities
Under Settings, “What Wysebee may do on this PC” has four more switches. Each is off until you turn it on and confirm, is forgotten when you unpair, and also needs the matching tool on the agent's Tools tab in Wysebee.
- Run any programTool in Wysebee: Run any program
The agent names a program and its arguments itself, still as an argument list, in your home folder, with the same time limit. A safeguard refuses disk, boot and backup tools, every shell and script host (cmd, PowerShell, WSL, Windows Script Host, mshta, rundll32…), tools that change accounts, permissions, services, scheduled tasks, the registry or the firewall, installers (msiexec, winget…), shutdown, file wipers, inline interpreter code, and git or robocopy with arguments that destroy data. It is a safeguard, not a sandbox.
- See and control the screenTool in Wysebee: Screen control
Screenshots of the primary display, the mouse and the keyboard, with a red ring drawn where it clicks. Another display is not captured or reached.
- Work as a developerTool in Wysebee: Developer access
Windows PowerShell (the default), pwsh or cmd commands, and reading and writing files anywhere on this PC, as you. A command runs up to 220 seconds, or as a background job (up to 8 at once) for builds and tests. The safeguard above does not apply here: turn it on only for an agent you trust with your account.
- Use Android phonesTool in Wysebee: Android Development Toolkit
The phones and emulators adb sees: install and launch apps, screenshots, logs and more. adb comes with Android Studio's SDK (its platform-tools folder is found on its own) or the standalone SDK Platform-Tools.
How it works
Claude / ChatGPT / Wysebee website
│ asks the agent to use a tool
▼
Wysebee Cloud ── runs the agent, queues the call
▲
│ the PC asks for work (HTTPS, outbound only)
▼
Wysebee Agent on your PC ── checks the call against what you allowed,
runs it, sends the result back- The PC makes the connection, over HTTPS to Wysebee Cloud. It opens no port to the internet, so it works behind any home or office network.
- It keeps one long request open and tells Wysebee its status: paused or not, the programs and skills you allowed, and your folders. A change you make in the window reaches Wysebee at once.
- When a call arrives, the app checks it against its own approvals, runs it, and sends back the answer. A call cancelled in Wysebee is stopped on the PC.
- If the connection drops, it tries again after 2, 5, 15, then every 30 seconds.
Security and privacy
- Approval lives on the PC, in the app's own state, and is never taken from Wysebee Cloud. The cloud can ask; only the PC decides.
- The link's secret is made on the PC and kept in the Windows Credential Manager. Wysebee Cloud keeps only a hash of it, and the secret is never sent anywhere else.
- Wysebee Cloud sees the program definitions and skill files (they are the agent's settings), each call's values and the output, kept until read and an hour at most; and your folders' names, paths, permissions and descriptions. What a folder tool reads or writes passes through it like any answer. Nothing else is uploaded from the PC.
- Blank values and program output are never written to the app's log.
- The app runs as you, with your permissions and no administrator rights, so that it can run the programs you allow; nothing more.
See the Privacy Policy for the full picture.
Pause, unpair, uninstall
- Pause: turn off “Run programs on this PC” in Settings, or choose Pause from the bee's menu. What is running stops and every call is refused until you resume.
- Unpair: Settings → Pairing → Unpair…. The link ends and the PC forgets the programs, approvals, folders, skill copies and switches. The agent stays in Wysebee; pair again and reconnect to use it.
- Uninstall: unpair, then remove Wysebee Agent under Windows Settings → Apps → Installed apps. Its data stays in the folder below, which you can delete too.
%LOCALAPPDATA%\Wysebee Agent\
state.json pairing, approvals, folders, switches
skills\ the allowed copy of each skill
skill-cache\ downloaded, checked skill files (never run)
agent.log the log, cleared at each launch
Credential Manager the link's secret (com.wysebee.agent.win)Troubleshooting
- Windows protected your PC (SmartScreen).
- Make sure you downloaded the installer from this site. A new release can be flagged until Windows has seen enough of it: choose More info, check the publisher, then Run anyway, and tell us on Discord.
- I closed the window and the app is gone.
- Closing the window only hides it; the app keeps running in the notification area. Click the bee by the clock (under the ^ if it is tucked away), or open Wysebee Agent again from the Start menu, and the window comes back. Quit is in the bee's right-click menu.
- The code expired, or Wysebee says the name is taken.
- Press Cancel and pair again for a fresh code. If the name belongs to an earlier Windows agent that has no PC now, Wysebee offers to reconnect to it instead; nothing is allowed on this PC until you click Allow again.
- A program says missing-program, or cannot be found.
- Wysebee Agent looks for the program when you click Allow: a full path, or a name on the PATH (as name, name.exe or name.com) plus your app execution aliases and Scoop's shims. Install it or use its full path in Wysebee, then click Allow again.
- My .bat or .cmd file is never found.
- On purpose: Windows runs batch files through cmd.exe, a shell, and Wysebee Agent never runs a program through a shell. Point the tool at the real program instead (python, node, the .exe the batch file starts), or turn on Developer access for shell commands.
- A program or skill keeps waiting after I changed it.
- That is on purpose: any change to the program, its arguments or a skill's files needs a new Allow on the PC. Put it back exactly as it was and it is allowed again.
- Allowing a new version of a skill says a file could not be written.
- Windows cannot replace a program that is running. Wait for the skill's script to finish, then click Allow again.
- The agent says the PC is offline.
- Wysebee Agent has to be running and connected, and not paused. Turn on Start at sign-in in Settings so it is there after a restart.
Support
Email support@wysebee.com or ask in the Wysebee Discord, where questions get answered and bugs get reported. The log at %LOCALAPPDATA%\Wysebee Agent\agent.log helps; it never holds your secret, blank values or output.
