๐Ÿšง Coming Soon โ€” This extension is under development. Star the repo to get notified!
๐Ÿš€

GitHub Deployment

Deploy your agents to GitHub Actions with automatic workflows, secrets management, and PR creation.

Deployment Features

โš™๏ธ GitHub Actions

Auto-generate workflow files for scheduled agent execution

๐Ÿ” Secrets Management

Securely store API keys and credentials in GitHub Secrets

๐Ÿ“ Pull Requests

Create PRs with agent code, policies, and documentation

๐Ÿ“Š Monitoring

Track workflow runs and receive failure notifications

Deployment Workflow

๐Ÿ“ Create Agent โ†’ ๐Ÿงช Test โ†’ ๐Ÿ”’ Add Secrets โ†’ ๐Ÿš€ Deploy โ†’ ๐Ÿ“Š Monitor

Quick Deployment

1 Deploy Your Agent

User: @agentos deploy
AgentOS: ๐Ÿš€ Deploying Agent to GitHub

Pre-deployment Checks:
โœ… Agent code validated
โœ… Policies attached
โœ… Tests passing
โœ… Security audit passed

Generated Files:
๐Ÿ“„ .github/workflows/data-sync-agent.yml
๐Ÿ“„ agents/data-sync-agent/main.py
๐Ÿ“„ agents/data-sync-agent/policy.yaml
๐Ÿ“„ agents/data-sync-agent/README.md

Required Secrets:
๐Ÿ”‘ DATABASE_URL - Your database connection string
๐Ÿ”‘ SLACK_WEBHOOK_URL - Slack notification webhook

Would you like to:
[Create PR] [Set Secrets First] [Preview Files]

2 Configure Secrets

User: @agentos set secret DATABASE_URL
AgentOS: ๐Ÿ” Setting Secret

Please provide the value for DATABASE_URL.
(This will be stored securely in GitHub Secrets)

Security:
โœ… Encrypted at rest
โœ… Only accessible to workflows
โœ… Not visible in logs

Enter value or paste connection string:

3 Create Pull Request

User: @agentos create pr
AgentOS: ๐Ÿ“ Creating Pull Request

PR Details:
Title: Add data-sync-agent with AgentOS policies
Branch: agentos/data-sync-agent
Base: main

Files Changed:
+ .github/workflows/data-sync-agent.yml (new)
+ agents/data-sync-agent/main.py (new)
+ agents/data-sync-agent/policy.yaml (new)
+ agents/data-sync-agent/README.md (new)

PR Description:
- ๐Ÿค– Automated data synchronization agent
- ๐Ÿ›ก๏ธ GDPR-compliant data handling
- โฐ Runs every 6 hours
- ๐Ÿ“Š Reports to Slack

โœ… PR Created: #42

Reviewers will be notified automatically.

GitHub Actions Workflow

AgentOS generates optimized workflow files:

# .github/workflows/data-sync-agent.yml
name: Data Sync Agent

on:
  schedule:
    - cron: '0 */6 * * *'  # Every 6 hours
  workflow_dispatch:  # Manual trigger

jobs:
  run-agent:
    runs-on: ubuntu-latest
    timeout-minutes: 30
    
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
          
      - name: Install dependencies
        run: pip install -r agents/data-sync-agent/requirements.txt
        
      - name: Run Agent with AgentOS
        uses: agentos/run-agent@v1
        with:
          agent-path: agents/data-sync-agent
          policy-path: agents/data-sync-agent/policy.yaml
        env:
          DATABASE_URL: ${{ secrets.DATABASE_URL }}
          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
          
      - name: Notify on failure
        if: failure()
        uses: slackapi/slack-github-action@v1
        with:
          payload: |
            {"text": "โš ๏ธ Data Sync Agent failed! Check logs."}

Secrets Management

Check and manage your agent's secrets:

User: @agentos check secrets
DATABASE_URL โœ… Set
SLACK_WEBHOOK_URL โœ… Set
API_KEY โŒ Missing
โš ๏ธ Security Note: Never commit secrets to your repository. Always use GitHub Secrets for sensitive values. AgentOS automatically detects and blocks commits containing secrets.

Schedule Configuration

Configure when your agent runs:

# Common schedule patterns

# Every hour
cron: '0 * * * *'

# Every 6 hours
cron: '0 */6 * * *'

# Daily at midnight UTC
cron: '0 0 * * *'

# Weekdays at 9am UTC
cron: '0 9 * * 1-5'

# Every Monday at 6am UTC
cron: '0 6 * * 1'
User: @agentos set schedule "every weekday at 9am"
AgentOS: โฐ Schedule Updated

New Schedule: Every weekday at 9:00 AM UTC
Cron Expression: 0 9 * * 1-5

Next Runs:
- Mon, Jan 27 at 9:00 AM UTC
- Tue, Jan 28 at 9:00 AM UTC
- Wed, Jan 29 at 9:00 AM UTC

Updated workflow file.

Monitoring Deployments

Track your deployed agents:

User: @agentos status
AgentOS: ๐Ÿ“Š Agent Status

data-sync-agent
โ”œโ”€โ”€ Status: โœ… Healthy
โ”œโ”€โ”€ Last Run: 2 hours ago (success)
โ”œโ”€โ”€ Next Run: in 4 hours
โ”œโ”€โ”€ Success Rate: 98.5% (197/200 runs)
โ””โ”€โ”€ Avg Duration: 45 seconds

Recent Runs:
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Time           โ”‚ Status   โ”‚ Duration โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ Today 12:00    โ”‚ โœ… Pass  โ”‚ 42s      โ”‚
โ”‚ Today 06:00    โ”‚ โœ… Pass  โ”‚ 48s      โ”‚
โ”‚ Yesterday 18:00โ”‚ โœ… Pass  โ”‚ 41s      โ”‚
โ”‚ Yesterday 12:00โ”‚ โŒ Fail  โ”‚ 12s      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

[View Logs] [Trigger Run] [Pause Agent]
๐Ÿ’ก Best Practice: Start with a manual workflow_dispatch trigger to test your agent, then add the schedule after confirming it works correctly.