localissue

Local issue management CLI for OpenClaw persistent agent system.

Installation

# Build release version
cargo build --release

# Install to persistent directory
mkdir -p ~/.openclaw/bin
cp target/release/localissue ~/.openclaw/bin/
chmod +x ~/.openclaw/bin/localissue

# Add to PATH
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Usage

Create an issue

localissue create --title "Implement feature X" --priority P1 --type feature
localissue create --title "Fix bug Y" --priority P0 --type bugfix --description "Details..."
localissue create --title "New task" --assignee agent-coding

Options:

• --title (required): Issue title
• --priority: P0 (urgent), P1 (important), P2 (normal), P3 (low) [default: P2]
• --type: feature, bugfix, refactor, docs, test [default: feature]
• --assignee: Assignee name [default: agent-main]
• --description: Issue description
• --json: Output as JSON

List issues

# List all issues
localissue list

# Filter by status
localissue list --status pending,in_progress

# Filter by priority
localissue list --priority P0,P1

# Combine filters
localissue list --status pending --priority P1,P2

# JSON output
localissue list --json

Show issue details

localissue show 001
localissue show 001 --json

Update an issue

# Update status
localissue update 001 --status in_progress

# Change assignee
localissue update 001 --assignee agent-coding

# Add notes
localissue update 001 --notes "Started implementation"

# Combine updates
localissue update 001 --status pending_review --assignee agent-review --notes "Ready for review"

Status values:

• pending
• in_progress (or inprogress)
• blocked
• pending_review (or pendingreview)
• done

Search issues

# Search in title, description, notes, and tags
localissue search rust
localissue search "bug fix"
localissue search cli --json

Delete an issue

# With confirmation
localissue delete 001

# Skip confirmation
localissue delete 001 --yes

Data Storage

Issues are stored in ~/.openclaw/issues/ as Markdown files with YAML frontmatter:

~/.openclaw/issues/
├── 001.md
├── 002.md
└── 003.md

Issue Format

Each issue is a Markdown file with YAML frontmatter:

---
id: "001"
title: "Implement feature X"
status: pending
priority: P1
type: feature
assignee: agent-main
created: 2026-02-25T04:49:30Z
updated: 2026-02-25T04:49:30Z
tags: [feature, important]
auto_complete: false
requires_approval: false
dependencies: []
github_url: null
---

## Description
Detailed description here

## Tasks
- [ ] Task 1
- [ ] Task 2

## Completion Criteria
- Criteria 1
- Criteria 2

## Notes
Additional notes

## History
- 2026-02-25 04:49: Created

JSON Output

All commands support --json flag for machine-readable output:

localissue list --json | jq -r '.[].id'
localissue show 001 --json | jq -r '.title'
localissue search rust --json | jq 'length'

Exit Codes

• 0: Success
• 1: General error
• 2: Issue not found
• 3: IO error
• 4: Parse error

Development

# Run in development
cargo run -- list

# Run tests
cargo test

# Build release
cargo build --release

License

MIT