CLI tools for agentic robotics framework
npm install @agentic-robotics/cli


Command-line tools for the agentic-robotics framework.
- š ļø Test Framework - Validate node creation and communication
- š System Info - Display framework version and capabilities
- ā” Quick Testing - Rapid prototyping and debugging
- š Diagnostics - Built-in health checks
- šÆ Simple Interface - Easy-to-use commands
Global installation (recommended):
``bash`
npm install -g @agentic-robotics/cli
Or use with npx:
`bash`
npx @agentic-robotics/cli test
Test node creation, publisher, and message publishing:
`bash`
agentic-robotics test
Run comprehensive system diagnostics to check your environment:
`bash`
agentic-robotics doctor
Verbose mode:
`bash`
agentic-robotics doctor --verbose
Output:
`
š„ Running Agentic Robotics Doctor...
š Checking Node.js version...
ā
Node.js v18.20.8 (>= 14.0.0 required)
š Checking @agentic-robotics/core...
ā
Core package loaded
ā
Node creation works
š Checking optional integrations...
ā
agentic-flow available (66 agents + 213 MCP tools)
ā
AgentDB available (13,000x faster memory)
ā
MCP server available
š Checking system resources...
š¾ Memory: 4.50 GB free / 8.00 GB total
š„ļø CPUs: 4 cores
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
š Doctor says: Everything looks good!
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
`
Enter interactive dialog mode to work with the robotics framework:
`bash`
agentic-robotics dialog
Interactive commands:
`
agentic> help
Available commands:
help - Show this help message
info - Show framework information
create
pub
send
stats - Show publisher statistics
status - Show current session status
agents - List available AI agents
clear - Clear screen
exit - Exit dialog mode
agentic> create my-robot
ā
Node "my-robot" created successfully
agentic> pub /commands
ā
Publisher created on topic: /commands
agentic> send Move forward 10 meters
ā
Message sent: "Move forward 10 meters"
agentic> stats
š Publisher Statistics:
Messages: 1
Bytes: 53
`
List available AI agents with optional filtering:
`bash`
agentic-robotics agents
Filter by category:
`bash`
agentic-robotics agents --category core
agentic-robotics agents --category swarm
agentic-robotics agents --category flow
Output:
`
š¤ Available AI Agents
š¦ Core Robotics Agents:
⢠AgenticNode - Core node for pub/sub communication
⢠AgenticPublisher - High-performance message publisher
⢠AgenticSubscriber - Message subscriber with callbacks
š Swarm Coordination (via agentic-flow integration):
⢠hierarchical-coordinator - Queen-led hierarchical coordination
⢠mesh-coordinator - Peer-to-peer mesh network
⢠adaptive-coordinator - Dynamic topology switching
⢠collective-intelligence - Distributed cognitive processes
⢠swarm-memory-manager - Distributed memory coordination
š§ Task Agents (66 total via agentic-flow):
Development:
⢠coder, reviewer, tester, planner, researcher
Specialized:
⢠backend-dev, mobile-dev, ml-developer, system-architect
⢠api-docs, cicd-engineer, production-validator
GitHub Integration:
⢠pr-manager, code-review-swarm, issue-tracker
⢠release-manager, workflow-automation, repo-architect
SPARC Methodology:
⢠sparc-coord, specification, pseudocode, architecture, refinement
`
Test node creation, publisher, and message publishing:
`bash`
agentic-robotics test
Output:
``
š¤ Testing Agentic Robotics Node...
ā
Node created successfully
ā
Publisher created
ā
Message published
ā
Message received
š Stats: { messages: 1, bytes: 66 }
Display framework version and capabilities:
`bash`
agentic-robotics info
Output:
`
š¤ Agentic Robotics Framework v0.1.3
š¦ ROS3-compatible robotics middleware
ā” High-performance native bindings
Available commands:
test - Test node creation and communication
info - Show this information
`
`bashInstall globally
npm install -g @agentic-robotics/cli
$3
`json
{
"scripts": {
"test:robot": "agentic-robotics test",
"info": "agentic-robotics info"
}
}
`Usage Examples
$3
`yaml
.github/workflows/test.yml
name: Test Robot Frameworkon: [push]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: '18'
- run: npm install -g @agentic-robotics/cli
- run: agentic-robotics test
`$3
`dockerfile
FROM node:18
RUN npm install -g @agentic-robotics/cli
HEALTHCHECK CMD agentic-robotics test || exit 1
`$3
`bash
#!/bin/bash
.git/hooks/pre-commit
agentic-robotics test || {
echo "ā Robot framework test failed"
exit 1
}
`API
The CLI uses the
@agentic-robotics/core package internally:`javascript
const { AgenticNode } = require('@agentic-robotics/core');// Test creates a node
const node = new AgenticNode('test-node');
// Creates a publisher
const publisher = await node.createPublisher('/test');
// Publishes a test message
await publisher.publish(JSON.stringify({
message: 'Hello, World!',
timestamp: Date.now()
}));
// Checks stats
const stats = publisher.getStats();
console.log('š Stats:', stats);
`MCP Server Binary
The
agentic-robotics package also includes the Model Context Protocol (MCP) server:`bash
agentic-robotics-mcp
`This launches an interactive MCP server with:
- Robot control tools: move_robot, get_pose, get_status
- Sensor tools: read_lidar, detect_objects
- Memory tools: query_memory, consolidate_skills, get_memory_stats
- AgentDB integration: 13,000x faster memory (5,725 ops/sec)
The MCP server enables AI assistants (like Claude) to interact with the robotics framework through the Model Context Protocol.
For more information, see @agentic-robotics/mcp.
Exit Codes
-
0 - Success (all tests passed)
- 1` - Failure (test failed or error occurred)- Node.js >= 14.0.0
- @agentic-robotics/core (peer dependency)
- agentic-robotics - Complete framework
- @agentic-robotics/core - Core bindings
- @agentic-robotics/mcp - MCP server
Visit ruv.io for more information and documentation.
MIT OR Apache-2.0