@elizaos/plugin-coding-agent 0.1.0-next.0

package/README.md

@@ -0,0 +1,169 @@
+# @milaidy/plugin-coding-agent
+
+Orchestrate CLI-based coding agents (Claude Code, Codex, Gemini CLI, Aider, Pi) via PTY sessions and manage git workspaces for autonomous coding tasks.
+
+## Features
+
+- **PTY Session Management**: Spawn, control, and monitor coding agents running in pseudo-terminals
+- **Git Workspace Provisioning**: Clone repos, create worktrees, manage branches
+- **PR Workflow**: Commit changes, push to remote, create pull requests
+- **Multi-Agent Support**: Claude Code, Codex, Gemini CLI, Aider, Pi, or generic shell
+
+## Installation
+
+This plugin is part of the Milaidy monorepo. It requires the following peer dependencies:
+
+```bash
+pnpm add pty-manager git-workspace-service
+```
+
+## Usage
+
+### Register the Plugin
+
+```typescript
+import { codingAgentPlugin } from "@milaidy/plugin-coding-agent";
+
+// Add to your ElizaOS agent configuration
+const agent = {
+  plugins: [codingAgentPlugin],
+  // ... other config
+};
+```
+
+### Actions
+
+#### PTY Session Management
+
+| Action | Description |
+|--------|-------------|
+| `SPAWN_CODING_AGENT` | Spawn a new coding agent session |
+| `SEND_TO_CODING_AGENT` | Send input or keys to a running agent |
+| `STOP_CODING_AGENT` | Terminate an agent session |
+| `LIST_CODING_AGENTS` | List all active sessions |
+
+#### Workspace Management
+
+| Action | Description |
+|--------|-------------|
+| `PROVISION_WORKSPACE` | Clone a repo or create a worktree |
+| `FINALIZE_WORKSPACE` | Commit, push, and optionally create PR |
+
+### Example Conversation
+
+```
+User: Spawn Claude Code to fix the auth bug in src/auth.ts
+Agent: Starting claude-code agent in /workspace...
+       Session ID: abc123, Status: running
+
+User: What coding agents are running?
+Agent: Active sessions:
+       1. claude-code (abc123...) - running
+          Working in: /workspace
+
+User: Tell it to accept the changes
+Agent: Sent "y" to coding agent.
+
+User: Create a PR for the fix
+Agent: Workspace finalized!
+       Commit: a1b2c3d4
+       PR #42: https://github.com/user/repo/pull/42
+```
+
+## Services
+
+### PTYService
+
+Manages PTY sessions for coding agents.
+
+```typescript
+import { PTYService } from "@milaidy/plugin-coding-agent";
+
+// Access via runtime
+const ptyService = runtime.getService("PTY_SERVICE") as PTYService;
+
+// Spawn a session
+const session = await ptyService.spawnSession({
+  agentType: "claude-code",
+  workdir: "/path/to/project",
+  initialTask: "Fix the auth bug",
+});
+
+// Send input
+await ptyService.sendToSession(session.id, "y");
+
+// Check status
+const info = ptyService.getSession(session.id);
+console.log(info.status); // "running" | "blocked" | "completed"
+
+// Stop session
+await ptyService.stopSession(session.id);
+```
+
+### CodingWorkspaceService
+
+Manages git workspaces for coding tasks.
+
+```typescript
+import { CodingWorkspaceService } from "@milaidy/plugin-coding-agent";
+
+// Access via runtime
+const workspaceService = runtime.getService("CODING_WORKSPACE_SERVICE");
+
+// Clone a repo
+const workspace = await workspaceService.provisionWorkspace({
+  repoUrl: "https://github.com/user/repo.git",
+  branch: "feature/my-feature",
+});
+
+// Create worktree for parallel work
+const worktree = await workspaceService.provisionWorkspace({
+  useWorktree: true,
+  parentWorkspaceId: workspace.id,
+  branch: "bugfix/issue-123",
+});
+
+// Commit and push
+await workspaceService.commit(workspace.id, {
+  message: "fix: resolve auth issue",
+  all: true,
+});
+await workspaceService.push(workspace.id, { setUpstream: true });
+
+// Create PR
+const pr = await workspaceService.createPR(workspace.id, {
+  title: "Fix auth issue",
+  body: "Resolves #123",
+});
+```
+
+## Configuration
+
+Configure via runtime settings:
+
+```typescript
+// PTY Service config
+runtime.setSetting("PTY_SERVICE_CONFIG", {
+  maxSessions: 5,
+  idleTimeoutMs: 30 * 60 * 1000,
+  debug: true,
+});
+
+// Workspace Service config
+runtime.setSetting("CODING_WORKSPACE_CONFIG", {
+  baseDir: "~/.milaidy/workspaces",
+  credentials: {
+    github: { token: process.env.GITHUB_TOKEN },
+  },
+  debug: true,
+});
+```
+
+## Dependencies
+
+- `pty-manager` - PTY session management with adapter pattern
+- `git-workspace-service` - Git workspace provisioning and PR creation
+
+## License
+
+MIT