Agent Studio Developer Guide

Overview

Package: @bluefly/agent-studio Version: Latest License: MIT

Multi-platform IDE with AI-powered agent orchestration for macOS, iOS, and iPadOS. Combines native Apple performance with AI-powered development tools and real-time cross-device sync.

Key Features

Multi-Platform Native Apps: macOS (SwiftUI), iOS, iPadOS, VSCode extension, Web interface
NeuronLink AI Integration: Autonomous coding, multi-LLM support, MCP protocol
Agent Orchestration: OSSA 1.0 compliant, agent discovery, task distribution
Cross-Device Sync: Real-time sync, conflict resolution, offline support
Development Tools: Integrated terminal, Git integration, code intelligence
Enterprise Features: RBAC, team collaboration, audit logging

Installation

macOS Desktop

git clone https://gitlab.bluefly.io/llm/npm/agent-studio.git
cd agent-studio
npm install
npm run build:macos
npm run start:macos

iOS / iPadOS

npm run mobile:install-ios      # iPhone
npm run mobile:install-ipad     # iPad

npm run dev:ios                 # Simulator
npm run dev:ipad                # Simulator

VSCode Extension

npm install -g @bluefly/agent-studio
# Or install from VSIX
code --install-extension AgentStudio-vscode.vsix

Quick Start

macOS

agent-studio
# Or
npm run dev:macos

iOS/iPadOS

Open Xcode project in ios-monitor/ or ipad-manager/
Select target device/simulator
Build and run (⌘R)

VSCode Extension

Open VSCode
Install Agent Studio extension
Open command palette (⌘⇧P)
Run "Agent Studio: Initialize Workspace"

API Reference

NeuronLink AI

import { NeuronLink } from '@bluefly/agent-studio/neuronlink';

const agent = new NeuronLink({
  model: 'claude-3-5-sonnet-20241022',
  mcpEnabled: true
});

// Autonomous code generation
await agent.executeTask({
  type: 'refactor',
  target: 'src/services/UserService.ts',
  instructions: 'Extract validation logic into separate service'
});

Agent Orchestration

import { AgentOrchestrator } from '@bluefly/agent-studio';

const orchestrator = new AgentOrchestrator({
  namespace: 'production',
  meshUrl: 'http://localhost:3005'
});

// Discover agents
const agents = await orchestrator.discoverAgents({
  capabilities: ['code-generation', 'testing']
});

// Execute task
const result = await orchestrator.executeTask({
  agentId: agents[0].id,
  task: {
    type: 'implement-feature',
    description: 'Add user authentication'
  }
});

Configuration

Environment Variables

# Backend API
AGENT_STUDIO_API_URL=http://localhost:3000
AGENT_STUDIO_WS_URL=ws://localhost:3000

# Agent Mesh
AGENT_MESH_URL=http://localhost:3005
AGENT_MESH_GRPC_PORT=50051

# NeuronLink AI
NEURONLINK_ANTHROPIC_API_KEY=~/.tokens/anthropic
NEURONLINK_OPENAI_API_KEY=~/.tokens/openai
NEURONLINK_MCP_ENABLED=true

# Observability
PHOENIX_COLLECTOR_ENDPOINT=http://localhost:6006

# Sync
SYNC_INTERVAL=5000
SYNC_CONFLICT_STRATEGY=merge

OSSA Configuration

ossa.config.yaml:

version: 0.1.9
compliance_level: gold

agents:
  auto_discovery: true
  spawn_on_demand: true
  health_check_interval: 30s

platforms:
  - macos
  - ios
  - ipados

integrations:
  buildkit: true
  agent_mesh: true

Testing

npm test
npm run test:macos
npm run test:ios
npm run test:ipad
npm run test:integration
npm run test:e2e
npm run test:coverage

Deployment

Local Development

docker-compose up -d
open http://localhost:3000  # Web UI

Kubernetes

npm run deploy:production
kubectl apply -f infrastructure/kubernetes/

Documentation

GitLab: https://gitlab.bluefly.io/llm/npm/agent-studio
OpenAPI Specs: openapi/