AIHostCheckGitHub
Open source · early stage · shipping

Host context
AI should not guess.

AIHostCheck gives GPT and AI coding agents evidence about a developer machine before they propose commands—across Windows, macOS, and Linux.

Download v0.1.0Explore the source
Read-onlyNo telemetryApache-2.0
aihostcheck-report.jsonverified
{  "schema_version": "1.0.0",  "platform": "linux/amd64",  "capabilities": {    "python": {      "status": "detected",      "value": "Python 3.12.4",      "evidence": [{        "source": "executable_probe"      }]    }  }}
AI-readableEvidence-backedOffline
Latest releasev0.1.0Aug 12, 2026
Native targets6AMD64 + ARM64
CI coverage3 OSWindows · macOS · Linux
Data sourceGitHubLive public project data
01 / THE GAP

One wrong assumption.
Ten wrong commands.

A chat model cannot see the machine in front of you. Even an agent with terminal access can confuse absence with missing permissions, unsupported checks, or the wrong runtime on PATH.

WITHOUT HOST CONTEXT
AI

Run sudo apt install...

YOU

I'm on Windows.

Assumption → friction → lost time
WITH AIHOSTCHECK
OSWindows 11 / amd64detected
ShellPowerShelldetected
Package managerwingetdetected
Evidence → relevant instruction
02 / HOW IT WORKS
01

Run locally

One standalone binary performs bounded, read-only checks. No account, runtime, administrator privilege, or network probe.

aihostcheck --json
02

Review the report

Inspect the JSON before sharing. Sensitive categories are excluded by design and reports are never uploaded.

schema_version: 1.0.0
03

Give AI evidence

The agent sees explicit status, value, and evidence—and knows when to ask for a safe check instead of guessing.

unknown ≠ absent
03 / WHY IT IS DIFFERENT

Not another system-info screenshot.

AIHostCheck is designed as a compatibility layer between a real host and an AI workflow. Its output is versioned, machine-readable, privacy-bounded, and explicit about uncertainty.

Inspect the JSON Schema
detectedPositive evidence exists
not_detectedSupported check found nothing
unknownEvidence cannot establish the fact
unsupportedNo supported check on this platform
errorA supported check failed
permission_deniedAccess was blocked
04 / PROJECT TRAJECTORY

Built honestly. Designed to grow.

AIHostCheck is an early-stage open-source project. The foundation ships today; broader validation and integrations are the next work—not claims we make in advance.

AVAILABLE NOW
  • Native Windows, macOS, and Linux CLI
  • Versioned JSON report contract
  • Hardware, runtime, container, and GPU evidence
  • Cross-OS CI and verified release checksums
  • Privacy, security, and contribution policies
BUILDING NEXT
  • 01Real-device validation matrix
  • 02Signed and easier installation paths
  • 03Deeper AI and GPU runtime diagnostics
  • 04Reusable adapters for agent workflows
  • 05Local report viewer and redaction assistance
See milestones and completion evidence
05 / ECOSYSTEM SUPPORT

What infrastructure support unlocks.

Developer program credits and tooling help an early open-source project turn a credible foundation into a tested public utility: more real-device coverage, safer releases, dependable hosting, and faster community feedback.

Cross-platform testingRelease signingDocumentation hostingObservability
THE SOURCE OF TRUTH IS PUBLIC

Read the code.
Run the release.
Challenge the evidence.

View on GitHubUse with an AI agent