Skip to content

Add Claude Code GitHub Workflow - #1

Merged
dundas merged 2 commits into
mainfrom
add-claude-github-actions-1761239357259
Jan 27, 2026
Merged

dundas merged 2 commits into
mainfrom
add-claude-github-actions-1761239357259

Conversation

@dundas

@dundas dundas commented Oct 23, 2025

Copy link
Copy Markdown
Owner

🤖 Installing Claude Code GitHub App

This PR adds a GitHub Actions workflow that enables Claude Code integration in our repository.

What is Claude Code?

Claude Code is an AI coding agent that can help with:

  • Bug fixes and improvements
  • Documentation updates
  • Implementing new features
  • Code reviews and suggestions
  • Writing tests
  • And more!

How it works

Once this PR is merged, we'll be able to interact with Claude by mentioning @claude in a pull request or issue comment.
Once the workflow is triggered, Claude will analyze the comment and surrounding context, and execute on the request in a GitHub action.

Important Notes

  • This workflow won't take effect until this PR is merged
  • @claude mentions won't work until after the merge is complete
  • The workflow runs automatically whenever Claude is mentioned in PR or issue comments
  • Claude gets access to the entire PR or issue context including files, diffs, and previous comments

Security

  • Our Anthropic API key is securely stored as a GitHub Actions secret
  • Only users with write access to the repository can trigger the workflow
  • All Claude runs are stored in the GitHub Actions run history
  • Claude's default tools are limited to reading/writing files and interacting with our repo by creating comments, branches, and commits.
  • We can add more allowed tools by adding them to the workflow file like:
allowed_tools: Bash(npm install),Bash(npm run build),Bash(npm run lint),Bash(npm run test)

There's more information in the Claude Code action repo.

After merging this PR, let's try mentioning @claude in a comment on any PR to get started!

dundas pushed a commit that referenced this pull request Nov 14, 2025
…tions

Implemented complete ADMP (Agent Dispatch Messaging Protocol) backend server
ready for Teleportation integration.

Features:
- Agent registration with Ed25519 keypair generation
- Heartbeat-based session management (60s interval, 5min timeout)
- Inbox operations (SEND, PULL, ACK, NACK, REPLY)
- Message leasing with visibility timeouts
- Signature verification for authenticated messaging
- Trust management (allowlist-based authorization)
- Background jobs for lease reclaim and message expiry
- Production-ready with Docker, health checks, structured logging

Architecture:
- src/utils/crypto.js - Ed25519 signing and verification
- src/storage/memory.js - In-memory storage (swappable with DB)
- src/services/agent.service.js - Agent lifecycle management
- src/services/inbox.service.js - Message delivery and processing
- src/middleware/auth.js - Authentication middleware
- src/routes/agents.js - Agent registration and heartbeat endpoints
- src/routes/inbox.js - Inbox operations endpoints
- src/server.js - Main server with background jobs

API Endpoints:
- POST /api/agents/register - Register new agent
- POST /api/agents/:id/heartbeat - Update heartbeat
- POST /api/agents/:id/messages - Send message (SEND)
- POST /api/agents/:id/inbox/pull - Pull message with lease (PULL)
- POST /api/agents/:id/messages/:mid/ack - Acknowledge (ACK)
- POST /api/agents/:id/messages/:mid/nack - Negative ack (NACK)
- POST /api/agents/:id/messages/:mid/reply - Reply to message
- GET /api/messages/:id/status - Get message status
- GET /api/agents/:id/inbox/stats - Get inbox statistics
- GET /api/stats - System-wide statistics

Deployment:
- Docker and docker-compose.yml for containerized deployment
- .env.example with all configuration options
- Health check endpoint at /health
- Graceful shutdown handling

Documentation:
- README.md with complete API documentation and examples
- examples/basic-usage.js demonstrating agent messaging workflow
- discovery/teleportation-mvp.md - Integration plan for Teleportation

Ready for:
- Teleportation session-to-agent mapping
- External agent messaging with handshake protocol
- Edge agent pattern for message filtering
- Production deployment

Refs: #1
@dundas
dundas merged commit d1af96c into main Jan 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant