Reads your baseline
Open the folder with expected-ports.csv and earlier reports, and the agent reads, searches and updates them.
Product
Port checker work, done with your own scanner
01
Southcode Desk is a Windows agent for a port checker routine on devices you own. It does not scan by itself: it runs the scanner you already use, reads what that scanner saved, compares it with your baseline and writes a short report. You choose the mode. In Ask first you approve each change.
Runs your scanner
Shell starts the command you chose and shows the real exit code on a card.
You decide each change
Ask first pauses before actions that change something. Plan only writes a plan and runs nothing.
What the agent can do in your folder
- Filesread_file, write_file, edit_file, grep and glob work in the chat's working folder, keeping baselines and reports with your project; a counter shows files created, edited and read.
- Shellruns terminal commands on your PC, such as your scanner and netstat -ano. Success is judged by the real exit code, and dangerous commands are blocked.
- Webweb_search and http_get read documentation pages, for example when a service's setting for its listening address is unclear.
- Screenshots and imagesocr reads text from a screenshot, such as a router status page you cannot export, and gen_image saves real image files.
- Orchestrationtask splits a long address list into smaller parts for parallel sub-agents, and run_on_model sends a hard step to a bigger model.
- Approval modesAuto-run acts at once, Ask first pauses before every action that changes something, and Plan only changes nothing. Plans survive restarts.
- Cronruns a saved prompt on a schedule, so a weekly comparison against your baseline can start without retyping it.
- Modelsconnect a cloud AI provider through a standard API endpoint, a model running locally on your PC, or the built-in model, and press Test to check it.
From scanner output to a short report
Paperwork is the agent's part. The scanner finds the ports, and each finding then becomes a keep, close or check line in a report that you read, change and accept as a diff.
Compare scans/today.txt with the baseline and draft a keep, close or check report.
- list_dir
scans/3 files - read_file
expected-ports.csv9 lines - read_file
scans/today.txt31 lines - grep
3389 scans/today.txt1 match - write_file
reports/changes.md+18 lines - read_file
reports/changes.mddiff ready
Waiting for your OK before the next stepRejectAccept
Two tasks you can hand over
Update the baseline after a change
You retired an old file server, so port 445 should now be closed on that PC. The agent reads expected-ports.csv with read_file, searches the new scan with grep, and edit_file proposes changing one row from keep to close. Nothing is saved yet. To open ports more securely, or to secure open ports you must keep, http_get can read the service's documentation pages for the setting that limits who can reach it, and the agent writes the options into a plan in Plan only mode. Shell then runs your scanner again. Read the diff, accept only the rows you agree with, and compare the second scan before you trust the result.
Keep every scan and report together
A scan means little a month later unless you can see what was compared. Your scanner command writes each scan under scans/, and write_file saves each report under reports/. The saved scan is the record, so check every row of the report against that raw file. Even a free network scan utility that documents devices leaves the comparison to you, and the agent drafts it while you decide. Ask first pauses before each file is written. Open a report beside the raw file and compare a few rows by hand before you trust the table. Check them.
What Southcode Desk does not do
Southcode Desk is not an open port scanner, a hosted service or a plugin. The scope is yours. It runs the commands you approve, so keep scans to devices you own or may test; any other use is outside its intended use and your responsibility. It cannot guarantee that code, scans or analysis are correct.
