Skip to content

lfeng/qoder-cli-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Qoder CLI Skill for OpenClaw

🤖 Delegate coding tasks to Qoder CLI with full feature support.

⚠️ Important: Print Mode Only

TUI mode is NOT supported in OpenClaw or other automated environments. This skill uses Print mode (-p flag) for all operations.

Features

  • Print Mode - Non-interactive automation (TTY-free)
  • Subagents - Specialized AI agents for specific tasks
  • Worktrees - Parallel development with Git worktrees
  • MCP Servers - Extend with Model Context Protocol tools
  • Quest Mode - Spec-driven delegated development
  • Memory System - AGENTS.md for project context
  • Granular Permissions - Fine-grained access control
  • Model Selection - Auto-routing or manual model selection
  • All-Sessions Ready - Works in group chats, DMs, and shared workspaces

Installation

This skill is designed for OpenClaw.

Option 1: Clone to Skills Directory

cd ~/.openclaw/workspace/skills
git clone https://github.com/lfeng/qoder-cli-skill.git qoder-agent

Option 2: Manual Installation

  1. Download this repository
  2. Place in ~/.openclaw/workspace/skills/qoder-agent
  3. The skill will be automatically loaded by OpenClaw

Prerequisites

  • OpenClaw installed and configured
  • Qoder CLI installed: curl -fsSL https://qoder.com/install | bash
  • Authentication: Set QODER_PERSONAL_ACCESS_TOKEN environment variable

Configuration

1. Set Up Authentication

Add your Qoder Personal Access Token to your shell configuration:

# Add to ~/.zshrc or ~/.bashrc
export QODER_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"

# Reload shell
source ~/.zshrc

Get your token from: https://qoder.com/account/integrations

2. Verify Installation

# Check Qoder CLI
qodercli --version

# Check authentication
qodercli status

Usage

Once installed, the skill is automatically available in OpenClaw. Just ask:

Basic Examples

"Use Qoder CLI to add error handling to the API calls"
"Refactor the authentication module using ultimate model"
"Review the code in src/ for security issues"

Advanced Usage

"Use Qoder CLI with worktree to fix issue #78 in parallel"
"Create a subagent for code review and use it to analyze src/"
"Run quest mode to build a REST API with authentication"

Model Selection

  • Default: auto (automatic model routing)
  • Best Quality: --model=ultimate (refactoring, architecture)
  • Quick Tasks: --model=efficient (simple fixes)
  • Code Review: --model=performance

Skill Structure

qoder-agent/
├── SKILL.md          # Main skill documentation (Print mode focus)
├── README.md         # This file
├── LICENSE           # MIT License
└── .gitignore        # Standard ignore patterns

Documentation

See SKILL.md for complete usage documentation including:

  • Print mode flags and options
  • Subagent creation and usage
  • Worktree parallel jobs
  • MCP server integration
  • Permission configuration
  • Memory system (AGENTS.md)
  • Model selection guide
  • Troubleshooting

Examples

Quick Task (Print Mode)

# One-shot task
qodercli -p "Add error handling to src/api.ts"

# With ultimate model
qodercli --model=ultimate -p "Refactor the authentication module"

# JSON output
qodercli --output-format=json -p "Analyze src/"

# Continue last session
qodercli -c -p "Continue the refactoring"

Subagents

Create agents/code-review.md:

---
name: code-review
description: Code review expert for security and quality
tools: Read, Grep, Glob, Bash
---

You are a senior code reviewer. Check for:
1. Security vulnerabilities
2. Code quality
3. Best practices

Use it:

qodercli -p "Use code-review subagent to analyze src/"

Worktrees (Parallel Development)

# Create parallel jobs
qodercli --worktree -p "Fix issue #78"
qodercli --worktree -p "Fix issue #99"

# List jobs
qodercli jobs --worktree

# Remove job
qodercli rm <jobId>

MCP Servers

# Add browser automation
qodercli mcp add playwright -- npx -y @playwright/mcp@latest

# Add knowledge base
qodercli mcp add deepwiki -- npx -y mcp-deepwiki@latest

# List servers
qodercli mcp list

Permissions

Configure in ~/.qoder/settings.json or ${project}/.qoder/settings.json:

{
  "permissions": {
    "allow": [
      "Read(/Users/demo/projects/myproject/**)",
      "Edit(/Users/demo/projects/myproject/**)"
    ],
    "ask": [
      "Read(!/Users/demo/projects/myproject/**)"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

Troubleshooting

Not Logged In

# Set environment variable
export QODER_PERSONAL_ACCESS_TOKEN="your_token"

# Check status
qodercli status

Permission Denied

# Use yolo mode (caution)
qodercli --yolo -p "task"

# Or configure permissions

TUI Mode Error

TUI mode is NOT supported in OpenClaw. Always use Print mode:

# ✅ Correct
qodercli -p "Your task"

# ❌ Wrong (will fail)
qodercli  # TUI requires interactive terminal

Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

License

MIT License - See LICENSE file for details.

Support

Acknowledgments

About

Qoder CLI Skill for OpenClaw

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors