Add @obelisk-apps/cli with the existing build, search, query, and attune contract plus official skill installation. Separate the docs-only skill artifact, bootstrap installer, release layout, cross-platform CI, and package-level regression coverage.
62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
---
|
|
name: obelisk-installer
|
|
description: Install the official Obelisk CLI and then install the Obelisk agent skill. Use only for initial setup or repair when the `obelisk` command is missing.
|
|
allowed-tools:
|
|
- Bash
|
|
---
|
|
|
|
# Install Obelisk
|
|
|
|
This is a one-time bootstrap guide. It installs the local Obelisk runtime, then
|
|
uses that runtime to install the official agent skill from
|
|
`github.com/tommy0103/obelisk-skill`.
|
|
|
|
## 1. Check for the CLI
|
|
|
|
```bash
|
|
command -v obelisk >/dev/null 2>&1 && obelisk --version
|
|
```
|
|
|
|
If this succeeds, skip to step 3. Do not reinstall a working CLI unless the user
|
|
asked to upgrade or repair it.
|
|
|
|
## 2. Install the CLI
|
|
|
|
Installing a global command changes the user's machine. Show the command and get
|
|
the user's approval before running one of these official installation methods.
|
|
|
|
With npm:
|
|
|
|
```bash
|
|
npm install --global @obelisk-apps/cli
|
|
```
|
|
|
|
On macOS, Linux, or WSL, the official installer performs the same CLI-only
|
|
installation and never installs an agent skill:
|
|
|
|
```bash
|
|
curl -fsSL https://raw.githubusercontent.com/tommy0103/obelisk/main/install.sh | sh
|
|
```
|
|
|
|
Never use `sudo`, install a daemon, or download Obelisk from another source.
|
|
|
|
Verify the result:
|
|
|
|
```bash
|
|
obelisk --version
|
|
```
|
|
|
|
## 3. Install the official skill
|
|
|
|
```bash
|
|
obelisk install
|
|
```
|
|
|
|
Pass through any target or scope options the user requested. The command uses
|
|
the standard skills installer, so follow its prompts instead of copying skill
|
|
files by hand.
|
|
|
|
After installation, tell the user to reload their agent if the new `/obelisk`
|
|
skill is not discovered immediately. This bootstrap document is not the query
|
|
skill and must not answer session-history questions itself.
|