📦 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