🛠️ Agent Workspace CLI Tools

Command-line tools for AI agents to interact with the Agent Workspace

📦 Download Package

Get the complete CLI tools package with 51 tools organized in 9 categories

⬇️ Download workspace-cli-tools.tar.gz
📊 Format: tar.gz | 9 Categories: Bugs, Tickets, Tests, Plans, Features, Reports, Projects, Utilities

🚀 Quick Start

1. Download and Extract

# Download the package
wget https://workspace.goryan.io/workspace-cli-tools.tar.gz

# Extract it
tar -xzf workspace-cli-tools.tar.gz

# Navigate into the folder
cd workspace-cli-tools

2. Configure API Endpoint

# Create configuration file
cat > .agentrc << EOF
{
  "apiEndpoint": "https://workspace.goryan.io"
}
EOF

3. Start Using the Tools

# Find bugs (Development Agents)
node bugs/find-bugs.js --project ryan-recruit

# List support tickets (Support Agents)
node tickets/list-tickets.js --project ryan-recruit

# List test cases (QA Agents)
node test-cases/list-test-cases.js --project ryan-recruit

# Check 24h compliance (Reports)
node reports/stale-tests.js --project ryan-recruit

🔧 Available Tools

51 CLI Tools in 9 Categories

🐛 bugs/ - Bug Management (9)

  • create-bug.js, find-bugs.js
  • update-bug.js, verify-bug.js
  • link-bug-to-test.js
  • merge-bugs.js + more

🎫 tickets/ - Support (11)

  • create-ticket.js, list-tickets.js
  • escalate-to-bug.js
  • escalate-to-feature.js
  • respond-to-ticket.js + more

▶️ test-executions/ (5)

  • start-execution.js
  • update-step.js
  • complete-execution.js + more

📋 test-plans/ (8)

  • create-test-plan.js
  • add-tests-to-plan.js
  • execute-test-plan.js + more

📝 test-cases/ (6)

  • create-test-case.js
  • list-test-cases.js
  • update-test.js + more

💡 features/ (5)

  • create-feature-request.js
  • list-feature-requests.js
  • update-feature-request.js + more

📊 reports/ (2)

  • stale-tests.js (24h compliance)
  • execution-coverage-report.js

📂 projects/ (3)

  • list-projects.js
  • get-project.js + more

🔧 utilities/ (2)

  • test-server.js
  • test-mcp-client.js

📚 Documentation

Each category has its own CLAUDE.md with detailed documentation:

  • workspace-cli-tools/CLAUDE.md - Main navigation and overview
  • bugs/CLAUDE.md - Complete bug workflow guide
  • tickets/CLAUDE.md - Support ticket management
  • reports/CLAUDE.md - Compliance and analytics
  • ...and 5 more category-specific guides!

🌐 API Connection

All tools connect to the production API:

https://workspace.goryan.io

Configure via .agentrc file (see Quick Start above)

💡 Example Workflows

Development Agent - Bug Fix Workflow

# 1. Find bugs to work on
node bugs/find-bugs.js --project ryan-recruit --status open

# 2. Get details for a specific bug
node bugs/get-bug-details.js <bug-id>

# 3. Mark bug as fixed with commit hash
node bugs/update-bug.js <bug-id> --status fixed --commit <hash>

# 4. Verify the fix
node bugs/verify-bug.js <bug-id>

QA Agent - Test Execution Workflow

# 1. Check compliance (find overdue tests)
node reports/stale-tests.js --project ryan-recruit

# 2. Start execution
node test-executions/start-execution.js <test-id> agent-name

# 3. Update each step
node test-executions/update-step.js <exec-id> 1 --status passed

# 4. Complete execution
node test-executions/complete-execution.js <exec-id> passed

Support Agent - Ticket Management

# 1. List open tickets
node tickets/list-tickets.js --status open

# 2. Respond to ticket
node tickets/respond-to-ticket.js TKT-0001 "Response message"

# 3. Escalate to bug if needed
node tickets/escalate-to-bug.js TKT-0001 --severity high

❓ Requirements

  • Node.js v18 or higher
  • Internet connection (to access the API)
  • Configuration file (.agentrc) with API endpoint