# Cohub Apps

> Publish a live web page or app at a stable URL — an HTML file, board, or directory site, or a running sandbox port — with versions, visibility, permissions, and view stats.

- Skill: `talesofai/cohub-apps` (Agent Skill)
- Install (CLI): `npx skillmds@latest add talesofai/cohub-apps`
- Raw SKILL.md: https://api.skillmd.com/api/skills/talesofai/cohub-apps/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: talesofai (https://skillmd.com/u/talesofai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/talesofai/cohub-apps

---


# 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

`--file` and `--dir` paths are relative to the target Space's workspace (the
same paths `spaces files ls` shows) — not the local filesystem. Inside a
sandbox, `/workspace` maps to the Space workspace, so project-relative paths
work as-is. Outside a sandbox, upload local build output first
(`spaces files upload <dir>`), then publish the Space-side path.

## 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.