SysControl: Instructions file for Claude Code

CLAUDE.md

SysControl CLAUDE.md is an instructions file for Claude Code from ks6573/SysControl. It costs 4,224 tokens per session, scanned A, original, MIT.

A project instruction guide for SysControl, an AI system-management agent with macOS, Windows, command-line, and MCP interfaces. MCP is a standard way for an AI model to call tools.

In plain words
What is it for?
Use it when working on SysControl’s Python backend, SwiftUI or Flet apps, command-line interface, or MCP server.
Why use it?
It explains the project’s architecture, platform differences, and communication paths so an agent can make changes safely.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions subagents; names the SlashCommand tool.

This is ks6573/SysControl's own configuration. It tells Claude Code how to work on SysControl itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything SysControl configures →

Reuse

Borrowing it

Nothing to install: this file belongs to ks6573/SysControl. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/ks6573/SysControl/master/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/ks6573/SysControl

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for SysControl CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ks6573/syscontrol/claude-md/github.svg)](https://agentmods.dev/instructions/ks6573/syscontrol/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/ks6573/syscontrol/claude-md"><img src="https://agentmods.dev/badge/instructions/ks6573/syscontrol/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for SysControl CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/ks6573/syscontrol/claude-md"><img src="https://agentmods.dev/badge/instructions/ks6573/syscontrol/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,224 This file is loaded in full into every session.
When invoked 4,224 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.04224 $0.04224
Opus 5.5 $0.01690 $0.01690
Sonnet 5.5 $0.00845 $0.00845
Haiku 4.5 $0.00422 $0.00422

Measured 2mo ago against content hash 251001afe441, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

SysControl CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 273 lines

How it starts

The opening of the file, as written. The whole thing — 273 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md — SysControl Project Guide

What is SysControl?

An AI agent for macOS and Windows 11 that answers questions about your system using 116 MCP tools. Four interfaces share the same Python backend: native SwiftUI app (macOS), Flet desktop app (Windows, flet_app/), CLI (cross-platform), and Claude Desktop (MCP server).

Repo: ks6573/SysControl on GitHub.

Cross-platform: the Python backend (agent/, mcp/, deep_research/, flet_app/) and the CLI run on macOS, Windows, and Linux. mcp/server.py branches on IS_MACOS/IS_LINUX/IS_WIN (see the get_startup_items() dispatcher pattern); macOS-only tools (AppleScript: iMessage/Mail/Calendar/Contacts/Notes, Homebrew, Time Machine) return a clean "not supported" dict off macOS rather than failing. The SwiftUI app is macOS-only; the Flet app is the Windows GUI (both drive the same backend).


Architecture

agent.py               ← CLI entry shim → agent.cli:main()
mcp/server.py          ← MCP server (~9200 lines, all 116 built-in tools, JSON-RPC over stdio)
mcp/connectors.py      ← External stdio MCP manager; minimal env + namespaced tool routing
mcp/tool_capabilities.py ← Platform, permission, category, and risk metadata for every tool
mcp/prompt.json        ← System prompt injected into all LLM requests
agent/core.py          ← Shared: MCPClient, MCPClientPool, run_streaming_turn(), TurnCallbacks
agent/bridge.py        ← JSON-over-stdio bridge for the Swift frontend
agent/cli.py           ← Interactive terminal agent (prompt_toolkit REPL, slash registry, /show, /init, /compact, --continue/--resume)
agent/cli_keys.py      ← KeyBindings (Enter/Ctrl-D submit semantics) + SIGINT install_sigint_handler context manager
agent/cli_completers.py← _SlashCompleter merge target + AtFileCompleter; submit-time @file expansion
agent/cli_session.py   ← Atomic JSON session store at ~/.syscontrol/cli_sessions/
agent/cli_compact.py   ← Synchronous /compact summarization with undo snapshot
agent/credentials.py   ← Native Keychain/Credential Manager storage with protected-file fallback
agent/automations.py   ← Persistent bounded scheduler + run history for read-only tool automations
agent/audit.py         ← Privacy-preserving JSONL audit log (argument names, never values)
agent/updater.py       ← `syscontrol --update` / `/update` self-update via uv tool install
agent/slash.py         ← SlashCommand dataclass + SlashRegistry consumed by cli.py
agent/agents.py        ← Sub-agent specs: AgentSpec, AgentRegistry, 5 built-in agents
agent/runner.py        ← Sub-agent runner: run_subagent() with isolated context + filtered tools
deep_research/         ← Deep research agent: iterative web research with claim verification
flet_app/              ← Native Windows desktop GUI (Flet, Python) — Windows counterpart to swift/
  main.py              ← Entry + frozen-bundle argv sentinel (--run-mcp-server / --selftest)
  app.py, controller.py← Page assembly + central orchestration; runs the backend in-process
  backend.py           ← run_streaming_turn() on a worker thread (no subprocess bridge needed)
  callbacks via controller; views/ (chat, sidebar, settings, onboarding), store/ (~/.syscontrol JSON)
scripts/make_icon.py   ← Generates .icns app icon from source image
swift/                 ← Native SwiftUI macOS app (macOS 14+)
  SysControl/
    App/               ← SysControlApp.swift (entry), AppState.swift (central @Observable)
    Services/          ← BackendService.swift (bridge IPC), UpdateService.swift
    Views/             ← SwiftUI views (Chat, Sidebar, Settings, InputBar, etc.)
    Models/            ← ChatMessage, ChatSession, ProviderConfiguration, SavedChat
    Storage/           ← PersistenceManager, ChatHistoryManager, ProviderConfigStore, PermissionConfigStore
  Package.swift        ← SPM manifest — explicit source list, must be updated when adding files
  build.sh             ← Builds .app bundle + optional .dmg (reads VERSION → Info.plist)
  install.sh           ← One-liner installer: clone, build, install to /Applications
VERSION                ← Single source of truth for app version

Read the full file on GitHub · 273 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 273 lines · 4,224 tokens per session scan A 251001afe441

Subscribe to this mod's changes

SysControl CLAUDE.md is an instructions file published in the GitHub repository ks6573/SysControl (0 stars, last pushed 3mo ago), licensed MIT. It adds 4,224 tokens to every session, about $0.0169 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

SysControl CLAUDE.md compared with instructions from other repositories

SysControl CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
SysControl CLAUDE.mdks6573/SysControlInstructions file03mo agoMITA4,224Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode