cohub-apps

PlatformBuilt-incohub/cohub-apps
Use it in Cohub

Paste this into your agent's chat — it fetches the skill and follows it.

Use the skill: cohub-apps. Run `npx -y @neta-art/neta-search-cli@latest skills use cohub/cohub-apps --via site` and follow what it prints. Read its complete output, redirecting it to a temporary file first if necessary, and resolve relative paths from the skill directory it prints.
Install from a terminal
npx -y @neta-art/neta-search-cli@latest skills use cohub/cohub-apps
Summary

Publish a web page or app at a permanent link that you can update and share.

  • Takes a file, a folder with a site, or a running preview and puts it live at a stable URL.
  • Update it anytime without changing the link; old versions stay available and you can see view counts.
  • Works for galleries, interactive boards, data dashboards, game prototypes, or any web page you build.
  • Control who can see it: everyone on the web, or only people with access to your workspace.
  • Apps can request permission to read or change files, run commands, or interact with your canvas material.
SKILL.md
# Cohub Apps

Cohub Apps publish as public pages:

```text
/:ownerUsername/:spaceSlug/w/:appSlug
```

If a command is unavailable, update the CLI: `npm install -g @neta-art/cohub-cli`.

## Inputs

A published App needs a target Space ID, an App slug, and one target. Use the current Space by default:

```bash
space_id="${COHUB_SPACE_ID:-}"
```

When the target Space is unclear, ask for the Space.

## Targets

Choose one target:

- `--file <path>` for an HTML page, board, or any other file
- `--dir <path>` for a directory site with `index.html`
- `--port 3000` or `--port 5173` for a running preview

## App Slug

Use a short, stable slug like `demo`, `report`, or `dashboard`. Keep an existing slug when updating an App. Ask before changing a user-provided slug.

## Visibility

Default to `public`. Use `--visibility space` when the App should be visible only to people with Space access.

## Permissions

Start with empty scopes. Add the smallest permission set needed for the App. Publisher scopes (`--app-scope`) apply on the App's home Space only:

- `space.view`
- `session.view`
- `file.view`
- `file.edit`
- `taskrun.view`
- `session.prompt.readonly`
- `session.prompt.fullaccess`
- `command.execute`

## Publish

Publish creates the App or updates an existing App with the same slug:

```bash
cohub -s "$space_id" apps publish "$app_slug" --file "$file" --json
cohub -s "$space_id" apps publish "$app_slug" --dir "$dir" --json
cohub -s "$space_id" apps publish "$app_slug" --port "$port" --json
```

Use `--visibility`, `--hide-cohub-bar` for immersive pages, `--meta <json>`, or `--disabled` as needed.

For an existing App that only needs a fresh version from its current target:

```bash
cohub apps publish-version "$app_id" --json
```

## App Ref

Refer to an App by id, public URL, `cohub://apps` URI, or `username/space/app`:

```bash
cohub apps get "$app" --json
```

Return `publicUrl`, falling back to `content.url` when needed.

## Manage

```bash
cohub apps ls
cohub apps update "$app_id" --visibility space --clear-app-scopes --json
cohub apps versions "$app_id"
cohub apps stats "$app"
cohub apps download "$app" -o ./out
cohub apps rm "$app_id" --yes
```

`update` can change the slug, visibility, target, scopes, and Cohub bar settings. `stats` shows view counts — total, 24h, 7d, 30d — and their sources.

## Desktop

Open an App window on the Cohub desktop that started this chat:

```bash
cohub desktop open "$app"
```

Add `--call <method>` to invoke a method the App registered.

## Identity Setup

If publishing reports missing public identity, check the Space and current user:

```bash
cohub spaces get "$space_id" --json
cohub auth whoami --json
```

If the current user is the Space owner, use user-provided or user-confirmed values to set the public identity:

```bash
cohub profile update --username "$owner_username" --json
cohub spaces update "$space_id" --slug "$space_slug" --json
```

## Safety

- Review target content before publishing.
- Confirm identity, permission, or status changes.
- Confirm before deleting an App.

## Finish

Return the public URL.
Related skills
agent-browserPlatformBrowse websites, fill forms, click buttons, take screenshots, and test web apps like a human.cohub-generatePlatformGenerate images, videos, music, and speech from your world's material and text prompts.cohub-boardPlatformBuild interactive boards with items, animations, and scripts that you can share or export as video.public-filesPlatformHost files on a permanent public link so anyone can download them directly.cohubPlatformSend messages to other spaces, schedule reminders, manage chats and files across your worlds.