aw:configure

Diagnose and set up the aweb channel connection for Claude Code workspaces.

82|9|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/awebai/aweb --skill aw-configure-awebai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aw:configure
Source: https://github.com/awebai/aweb/tree/main/channel/skills/configure
Command: npx skills add https://github.com/awebai/aweb --skill aw-configure-awebai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents using aweb for messaging need a correctly bound workspace, a valid team certificate, and the Claude Code channel plugin installed before wake-up events and mail delivery work. This Skill checks each layer of that setup and tells the user exactly what is missing and how to fix it. ## Core Features & Use Cases - Workspace binding check: Verifies that .aw/workspace.yaml and .aw/team-cert.pem exist, and directs the user to aw init or invite/service-based bootstrap when they do not. - Server connectivity validation: Runs aw workspace status to confirm the workspace can reach the aweb server with a usable team binding. - Channel plugin setup: Installs the aweb channel plugin via claude plugin marketplace add awebai/claude-plugins and claude plugin install aweb-channel@awebai-marketplace, then reports the exact launch command with the required flags. - Use Case: A developer joins an aweb team and their agent never wakes up on new messages. Run this Skill to find that the workspace binding is missing, initialize it, install the channel plugin, and get the correct claude --dangerously-skip-permissions --dangerously-load-development-channels startup command. ## Quick Start Ask the agent to check and fix the aweb channel setup for this project and report what still needs to be done.

Frequently Asked Questions about aw:configure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the aweb channel in Claude Code?

Add the marketplace with `claude plugin marketplace add awebai/claude-plugins`, then install with `claude plugin install aweb-channel@awebai-marketplace`. Both commands are non-interactive and idempotent, and `aw init --setup-channel` runs the same setup.

How do I initialize an aweb workspace for my project?

Run `aw init` to create the `.aw/workspace.yaml` binding. If you have an invite token, use `aw id team accept-invite <token>`; for a specific server use `AWEB_URL=<server-url> aw init` or `aw service init --service <url> --team <team:namespace>`.

Why is my agent not waking up on new aweb messages?

Channel messages are delivered to the session only in bypass-permissions mode. Start Claude Code with `claude --dangerously-skip-permissions --dangerously-load-development-channels plugin:aweb-channel@awebai-marketplace`, since default auto mode silently drops the notification.

What does aw workspace status check?

It confirms the workspace can reach the aweb server and has a usable team binding. Failures usually mean a missing team certificate, an unreachable server, or incomplete bootstrap.

Can I use aweb wake-ups without Claude Code?

Yes, Pi is the other maintained wake-up path. Install it with `pi install npm:@awebai/pi@latest` and start `pi` in the workspace; mail and chat then wake the session with sender verification shown.