Skip to content

AstraSyncAI/astrasync-gemini-extension

BranchesTags

Repository files navigation

AstraSync Gemini CLI Extension

Register and verify AI agents with blockchain-based identity directly from your terminal using Google's Gemini CLI.

License: MIT Gemini CLI Gemini CLI v0.17.1+

What is this?

The AstraSync Gemini CLI Extension brings AI agent identity management to your command line. Think of it as "SSL certificates for AI agents" - providing verifiable identity, ownership tracking, and compliance infrastructure through natural conversation with Gemini.

Key Features

  • Natural Language Registration: Register agents through conversation, no forms required
  • Instant Verification: Check any agent's registration status and trust score
  • Blockchain-Based Identity: Every agent gets a cryptographically secure, immutable identity
  • Trust Scoring: 0-100 trust scores help you evaluate agent credibility
  • Ownership Transfers: Transfer agent ownership securely (Developer tier)
  • Crypto Keypairs: Sign registrations with cryptographic proof (1 free, unlimited on Developer tier)

Prerequisites

Before installing this extension, you need:

  1. Gemini CLI v0.17.1 or higher installed and configured

    • Installation guide
    • Important: Version 0.17.1+ is required for StreamableHTTP MCP support
    • Check your version: gemini --version
    • Update if needed: npm install -g @google/gemini-cli@latest

  2. AstraSync MCP Bridge running locally

    • Self-hosting instructions
    • Default URL: http://localhost:3000/mcp/v1
    • Or wait for hosted version at https://astrasync.ai/mcp/v1 (coming soon)

  3. AstraSync Account (free to create)

Installation

Option 1: Install from GitHub (Recommended)

gemini extensions install https://github.com/AstraSyncAI/astrasync-gemini-extension

Option 2: Install Locally

# Clone the repository
git clone https://github.com/AstraSyncAI/astrasync-gemini-extension.git
cd astrasync-gemini-extension

# Install via Gemini CLI
gemini extensions install .

Configuration

After installation, Gemini will prompt you to configure the extension:

1. Email Address (Required)

Your AstraSync account email address.

Email Address: you@example.com

2. API Key (Optional but recommended)

Get your API key from astrasync.ai/settings/developer-tools

API Key: as_xxxxxxxxxxxxxxxxxxxxxxxx

If you don't have an API key yet, you can generate one through the web dashboard or via OAuth flow (coming soon).

3. MCP Server URL (Optional)

Default: http://localhost:3000/mcp/v1

If you're running the MCP bridge on a different port or using a hosted instance, update this URL.

MCP Server URL: http://localhost:3000/mcp/v1

Usage

Quick Commands

Use these shortcut commands for common tasks:

# Register a new agent
/astrasync-register

# Verify an agent's status
/astrasync-verify

# Learn about trust scores
/astrasync-trust-score

Natural Language

Or just ask Gemini naturally:

$ gemini

You: Register my customer support agent
Gemini: I'll help you register your agent. What's the agent's name?

You: SupportBot Pro
Gemini: Great! What does SupportBot Pro do?

You: Handles customer inquiries via chat and email
Gemini: Perfect. What's your email address?

You: you@example.com
Gemini: And who owns this agent? (Your name or company)

You: ACME Corporation
Gemini: Registering SupportBot Pro now...

✅ Successfully registered!
Agent ID: ASTRAS-123456
Trust Score: 45/100 (Free tier baseline)
Blockchain: Queued for verification

View agent card: https://astrasync.ai/agents/ASTRAS-123456

Features by Tier

Free Tier (Default)

  • ✅ Unlimited agent registrations
  • ✅ 1 crypto keypair
  • ✅ Email notifications
  • ✅ Agent verification
  • ⚠️ Max trust score: 50/100 (agents), 40/100 (developers)
  • ⚠️ Limited verification events
  • ❌ No ownership transfers

Developer Tier ($9/month)

  • ✅ Everything in Free tier
  • ✅ Ownership transfers (transfer agents to other developers)
  • ✅ Unlimited crypto keypairs
  • ✅ KYD identity verification (boost trust score to 85/100)
  • ✅ Cryptographic signing of registrations
  • ✅ Public developer profile
  • ✅ Higher verification event limits
  • ✅ Priority support

Upgrade to Developer tier

Common Workflows

Register Your First Agent

$ gemini

You: Register my new AI agent named "DataAnalyzer" that performs automated data analysis
Gemini: [Collects remaining info and registers]

✅ Agent ID: ASTRAS-789012
Trust Score: 45/100

Check Agent Status

You: What's the status of agent ASTRAS-789012?
Gemini: [Uses verify_agent tool]

Agent: DataAnalyzer (ASTRAS-789012)
Status: Active
Trust Score: 45/100
Blockchain: Verified ✅
Owner: you@example.com

Improve Trust Score

You: How can I increase my trust score?
Gemini: Your current maximum is 50/100 on the free tier.

To unlock higher trust scores (up to 85/100):
• Upgrade to Developer tier ($9/month)
• Complete KYD identity verification
• Use crypto keypairs to sign registrations

This is important for:
- Production deployments
- Compliance requirements
- Enterprise customers

Upgrade: https://astrasync.ai/pricing

Transfer Ownership (Developer Tier)

You: Transfer agent ASTRAS-789012 to alice@example.com
Gemini: Ownership transfers require the Developer tier ($9/month).

Benefits:
• Secure cryptographic transfer of agent control
• Complete audit trail of ownership history
• Blockchain-verified transfer records

Upgrade: https://astrasync.ai/pricing

Troubleshooting

"MCP server not responding"

Problem: The MCP bridge isn't running or accessible.

Solution:

# Check if MCP bridge is running (default port 3000)
curl http://localhost:3000/health

# If not, start it:
cd astrasync-mcp-bridge
npm start

# If port 3000 is already in use, start on a different port:
PORT=3005 npm start

# Then update the extension config to match:
# Edit ~/.gemini/extensions/astrasync/gemini-extension.json
# Change "httpUrl": "http://localhost:3000/mcp/v1"
# To:     "httpUrl": "http://localhost:3005/mcp/v1"

"API key invalid"

Problem: API key is missing, expired, or incorrect.

Solution:

  1. Visit astrasync.ai/settings/developer-tools
  2. Generate a new API key
  3. Update extension settings: 
    gemini extensions configure astrasync

"Rate limit exceeded"

Problem: You've hit the free tier verification event limit.

Solution:

  • Wait for the rate limit window to reset (typically 1 hour)
  • Or upgrade to Developer tier for higher limits: astrasync.ai/pricing

Extension not loading

Problem: Extension files not found or invalid configuration.

Solution:

# Reinstall the extension
gemini extensions uninstall astrasync
gemini extensions install https://github.com/AstraSyncAI/astrasync-gemini-extension

# Verify installation
gemini extensions list

"Keychain is not available" (WSL/Linux)

Problem: System keychain not available in WSL or some Linux environments.

Note: This issue has been fixed in the extension. API keys are now stored in plain text configuration instead of encrypted keychain. If you still see this error, update to the latest version:

# Update to latest version
gemini extensions uninstall astrasync
gemini extensions install https://github.com/AstraSyncAI/astrasync-gemini-extension

Security note: Since API keys are stored in plain text, ensure your ~/.gemini/ directory has appropriate file permissions.

Development

Local Development

# Clone the repository
git clone https://github.com/AstraSyncAI/astrasync-gemini-extension.git
cd astrasync-gemini-extension

# Make your changes
# Edit gemini-extension.json, GEMINI.md, or commands/*.toml

# Test locally
gemini extensions install .

# Test the extension
gemini

File Structure

astrasync-gemini-extension/
├── gemini-extension.json    # Extension configuration
├── GEMINI.md                # Context and AI instructions
├── README.md                # This file
├── LICENSE                  # MIT license
├── commands/                # Custom commands
│   ├── register.toml        # Quick registration
│   ├── verify.toml          # Quick verification
│   └── trust-score.toml     # Trust score info
└── .github/
    └── workflows/
        └── install-deps.yml # Dependency automation

Contributing

We welcome contributions! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Security

Sensitive Data

The extension handles sensitive data securely:

  • API Keys: Stored in system keychain (encrypted)
  • Crypto Private Keys: Never transmitted, stored securely
  • Mnemonic Phrases: Sent via email only, never logged

Best Practices

  • Never share your API key publicly
  • Save mnemonic phrases offline securely (they can't be recovered)
  • Use environment-specific API keys for dev/staging/production
  • Regularly rotate crypto keypairs for security

Links

About AstraSync

AstraSync is building the trust infrastructure for AI agents. We provide:

  • Verifiable Identity: Blockchain-based agent registration
  • Ownership Tracking: Cryptographic proof of agent ownership
  • Trust Scoring: 0-100 scores for agent credibility
  • Compliance Infrastructure: Audit trails for regulated industries

Learn more at astrasync.ai

License

MIT License - see LICENSE for details.

Made with ❤️ by AstraSync AI

Making AI agents accountable, one registration at a time.

About

Gemini CLI extension for AstraSync - Coming Soon! (Currently blocked - see Issue #1 for details)

astrasync.ai

Topics

identity mcp blockchain ai-agents trust-score gemini-cli agent-registration gemini-extension

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages