@graphteon/juricode

Juricode CLI

We are forging the future with lines of digital steel

A CLI version of the OpenHands frontend, providing command-line access to OpenHands functionality.

Installation

npm install -g @graphteon/juricode

Usage

juricode --help

Features

• Suggested Tasks: Browse and start working on AI-suggested tasks from your repositories
• Multi-Provider Support: GitHub, GitLab, and Bitbucket integration
• Enhanced Settings: Budget management and email verification
• Modern API: Updated to match OpenHands frontend v0.45.0
• CLI Interface: Full command-line access to OpenHands features

Recent Updates (v0.2.0)

New Features

• Suggested Tasks Menu: Browse failing checks, merge conflicts, and open issues
• Added Bitbucket provider support
• Enhanced settings with budget management (MAX_BUDGET_PER_TASK)
• Email verification support (EMAIL, EMAIL_VERIFIED)
• Updated API client to match OpenHands frontend structure
• Improved TypeScript configuration with DOM support

API Updates

• New open-hands.ts API client with comprehensive conversation management
• Enhanced authentication and error handling
• Support for microagents and trajectory management
• Git integration with change tracking and diff viewing

Type System

• Updated settings types with new provider options
• Added conversation and runtime status enums
• Enhanced type safety with proper imports and exports

Development

npm install
npm run build

Build Scripts

• npm run build:esm - Build ES modules
• npm run build:cjs - Build CommonJS modules
• npm run build:types - Generate TypeScript declarations
• npm run build - Build all formats

Usage Guide

Main Menu Options

• 📋 View All Tasks - Browse existing conversations and tasks
• 💡 Suggested Tasks - Browse AI-suggested tasks from your repositories
  • Failing CI/CD checks that need attention
  • Merge conflicts requiring resolution
  • Open issues ready for development
• 📚 Browse Repositories - Explore your connected repositories
• 📝 Create New Task - Start a new conversation/task manually

Suggested Tasks Workflow

• Select "💡 Suggested Tasks" from main menu
• Browse categorized tasks:
  • ❌ FAILING_CHECKS - CI/CD failures needing fixes
  • 🔀 MERGE_CONFLICTS - Pull requests with conflicts
  • 📋 OPEN_ISSUE - Issues ready for development
• Select a task to view details
• Choose "🚀 Start Working on Task" to create a conversation
• Optionally start an immediate chat session with the AI

Configuration

Environment Variables

Set the OpenHands base URL:

export JURICODE_BASE_URL=http://localhost:3000

For websocket connections (if different from base URL):

export JURICODE_WS_URL=http://localhost:3000

Set connection timeout (default: 10000ms):

export JURICODE_TIMEOUT=15000

Troubleshooting WebSocket Issues

If you encounter websocket connection errors when using chat functionality:

• Check OpenHands Backend: Ensure OpenHands backend is running and accessible
• Verify URL: Make sure JURICODE_BASE_URL points to the correct OpenHands instance
• Network Issues: Check if there are firewall or proxy issues blocking websocket connections
• Port Forwarding: If using SSH tunnels, ensure websocket ports are properly forwarded

Example with SSH tunnel:

# Forward both HTTP and WebSocket ports
ssh -L 3000:localhost:3000 user@remote-host

# Then run juricode
export JURICODE_BASE_URL=http://localhost:3000
juricode

Configuration Examples

For local development:

export JURICODE_BASE_URL=http://localhost:3000
juricode

For remote OpenHands with SSH tunnel:

ssh -L 3000:localhost:3000 user@remote-host
export JURICODE_BASE_URL=http://localhost:3000
juricode

License

MIT

Contributing

This project is synchronized with the OpenHands frontend. When updating, ensure compatibility with the latest OpenHands release.