Skip to content

feat: add PicoClaw personal AI agent stack#690

Open
akurinnoy wants to merge 1 commit into
devfile:mainfrom
akurinnoy:feat/picoclaw-stack
Open

feat: add PicoClaw personal AI agent stack#690
akurinnoy wants to merge 1 commit into
devfile:mainfrom
akurinnoy:feat/picoclaw-stack

Conversation

@akurinnoy

@akurinnoy akurinnoy commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Description of Changes

Add PicoClaw as a devfile registry sample - an open-source personal AI assistant (Go, MIT).

The stack runs two services in a sidecar container:

  • Web UI (picoclaw-launcher) on port 18800 - configure agents, channels, API keys
  • Gateway HTTP server on port 18790 - webhook endpoint for chat channels

The editor (VS Code, ttyd, etc.) is chosen separately in the dashboard and injected into the tools container.

Related Issue(s)

N/A

Acceptance Criteria

  • Contributing guide

Have you read the devfile registry contributing guide and followed its instructions?

  • Test automation

Does this repository's tests pass with your changes?

  • Documentation

Does any documentation need to be updated with your changes?

  • Check Tools Provider

Have you tested the changes with existing tools, i.e. Odo, Che, Console? (See devfile registry contributing guide on how to test changes)

Tests Performed

  • Started a workspace from the PicoClaw sample on an OpenShift cluster (CRC)
  • Verified the web UI is accessible on port 18800
  • Verified the gateway endpoint is accessible on port 18790
  • Ran picoclaw onboard and picoclaw status commands from the terminal
  • Confirmed config persists across workspace restarts (PVC at /home/user/.picoclaw)

How To Test

  1. Build a custom devfile registry image with this change
  2. Deploy it to a Che/DevSpaces cluster
  3. Create a workspace from the PicoClaw sample
  4. Open the web UI endpoint and run picoclaw onboard to configure an API key
  5. Verify the gateway and web UI endpoints work

Notes To Reviewer

  • The image runs as non-root with HOME=/home/user set explicitly for OpenShift arbitrary UID compatibility
  • Both endpoints use cookiesAuthEnabled: true for authentication through the Che gateway
  • No starterProjects - the sample is a standalone agent, not a code project

Summary by CodeRabbit

  • New Features
    • Added a new PicoClaw workspace stack with a ready-to-use development environment.
    • Included a launcher setup with web UI and gateway access, plus persistent configuration storage.
    • Added workspace commands to onboard, check status, and start the gateway.
    • Registered PicoClaw as a new available stack version and default option.

@akurinnoy akurinnoy requested a review from a team as a code owner June 30, 2026 14:44
@openshift-ci openshift-ci Bot requested review from elsony and michael-valdron June 30, 2026 14:44
@openshift-ci

openshift-ci Bot commented Jun 30, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: akurinnoy
Once this PR has been reviewed and has the lgtm label, please assign jdubrick for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@coderabbitai

coderabbitai Bot commented Jun 30, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: d607d923-b2b1-4e46-ab4c-1f6098ebcfc2

📥 Commits

Reviewing files that changed from the base of the PR and between 6240f65 and ba8cfc9.

📒 Files selected for processing (2)
  • stacks/picoclaw/1.0.0/devfile.yaml
  • stacks/picoclaw/stack.yaml
✅ Files skipped from review due to trivial changes (1)
  • stacks/picoclaw/stack.yaml
🚧 Files skipped from review as they are similar to previous changes (1)
  • stacks/picoclaw/1.0.0/devfile.yaml

📝 Walkthrough

Walkthrough

Two new files register the PicoClaw workspace stack: stack.yaml adds stack metadata and default version 1.0.0, and devfile.yaml defines the workspace metadata, containers, endpoints, storage, and commands.

Changes

PicoClaw Stack

Layer / File(s) Summary
Stack registry entry
stacks/picoclaw/stack.yaml
Defines the stack name, display name, description, icon, and default version 1.0.0.
Devfile metadata and storage config
stacks/picoclaw/1.0.0/devfile.yaml
Adds devfile schema version, workspace metadata, first-boot instructions, and the controller.devfile.io/storage-type attribute.
Container components and persistent volume
stacks/picoclaw/1.0.0/devfile.yaml
Defines the tools container and picoclaw launcher container with env vars, two public HTTPS endpoints (webui:18800, gateway:18790), a mount at /home/user/.picoclaw, and the picoclaw-data 1Gi PVC.
Devfile commands
stacks/picoclaw/1.0.0/devfile.yaml
Adds onboard, status, and start-gateway commands targeting the picoclaw component with /home/user as working directory.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 PicoClaw hops into the stack,
Two containers and endpoints on track.
A gateway, a UI, commands to run,
The workspace is ready—setup complete, fun!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding the PicoClaw personal AI agent stack.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@akurinnoy akurinnoy requested a review from ibuziuk June 30, 2026 14:44

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
stacks/picoclaw/1.0.0/devfile.yaml (1)

37-47: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Pin both container images to immutable refs.

ubi9-latest and picoclaw:launcher are mutable, so stack 1.0.0 will not be reproducible over time. Please use a versioned tag or digest for both images before publishing this registry version.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@stacks/picoclaw/1.0.0/devfile.yaml` around lines 37 - 47, Both container
images are using mutable tags, which makes this stack version non-reproducible
over time. Update the Devfile entries for the universal-developer-image and the
picoclaw launcher container to use immutable references such as a versioned tag
or digest, and make sure the container definitions in devfile.yaml reflect those
pinned image values before publishing 1.0.0.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@stacks/picoclaw/1.0.0/devfile.yaml`:
- Around line 65-72: The public webhook target defined under the gateway entry
is still requiring workspace cookie auth, which blocks third-party POSTs from
reaching the endpoint. Update the gateway attributes in the devfile so the
webhook path does not depend on cookiesAuthEnabled, keeping the rest of the
public exposure settings intact. Use the gateway service definition to locate
and adjust the auth-related attributes only.

---

Nitpick comments:
In `@stacks/picoclaw/1.0.0/devfile.yaml`:
- Around line 37-47: Both container images are using mutable tags, which makes
this stack version non-reproducible over time. Update the Devfile entries for
the universal-developer-image and the picoclaw launcher container to use
immutable references such as a versioned tag or digest, and make sure the
container definitions in devfile.yaml reflect those pinned image values before
publishing 1.0.0.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3226b987-86ad-4d07-866f-df9db5961b52

📥 Commits

Reviewing files that changed from the base of the PR and between 1c251d3 and 6240f65.

📒 Files selected for processing (2)
  • stacks/picoclaw/1.0.0/devfile.yaml
  • stacks/picoclaw/stack.yaml

Comment thread stacks/picoclaw/1.0.0/devfile.yaml
@akurinnoy akurinnoy marked this pull request as draft June 30, 2026 14:59
Add PicoClaw - an open-source personal AI assistant - as a devfile
registry sample. Includes web UI on port 18800 and gateway on
port 18790 with per-workspace storage.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Oleksii Kurinnyi <okurinny@redhat.com>
@akurinnoy akurinnoy force-pushed the feat/picoclaw-stack branch from 6240f65 to ba8cfc9 Compare June 30, 2026 15:11
@akurinnoy akurinnoy marked this pull request as ready for review June 30, 2026 15:55
@openshift-ci openshift-ci Bot requested review from Jdubrick and johnmcollier June 30, 2026 15:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant