github-cli

Agent OS GitHub CLI Extension

Part of Agent OS - Kernel-level governance for AI agents

GitHub CLI extension for Agent OS - The Linux Kernel for AI Agents

Installation

gh extension install imran-siddique/gh-agent-os

Commands

Run a task with governance

gh agent-os run "analyze this codebase for security issues"

Audit your codebase

gh agent-os audit --policy strict

Initialize Agent OS

gh agent-os init

Check status

gh agent-os status

Policy Levels

• strict: Maximum safety, requires human approval
• standard: Balanced safety and autonomy (default)
• permissive: Minimal restrictions

Configuration

After running gh agent-os init, customize .agent-os/policy.yaml:

version: 1
name: my-policy

governance:
  max_tokens: 4096
  max_tool_calls: 10
  timeout_seconds: 300

safety:
  confidence_threshold: 0.8
  require_human_approval: false

blocked_patterns:
  - "rm -rf"
  - "DROP TABLE"

allowed_tools:
  - read_file
  - write_file

Learn More

• Agent OS Documentation
• Integration Guide