pi-featherless — Kali Linux Rebuild

Attribution: This is a rebuilt, Kali Linux-targeted copy of the original CodeDoes/pi-featherless project. The original code, structure, and model registry were created by CodeDoes / KitAstro (AstralCosmo). This repository fixes the upstream syntax error, restores the build, adapts the package scope for the published Pi agent, and adds Kali install/update paths.

What was changed compared to upstream?

| Item | Upstream | This rebuild | |------|----------|--------------| | src/models.ts | Dangling tool_use: true, block (syntax error) | Fixed — orphan block removed | | src/models.ts getModelClass() | Only exact-id lookup | Falls back to known class patterns so removed-but-still-referenced models behave correctly | | package.json | Self-dependency @codedoes/pi-featherless: "." | Removed — avoids pnpm registry 404 | | Package scope | @mariozechner/pi-* | Switched to @earendil-works/pi-ai / @earendil-works/pi-coding-agent | | Distribution | Nur Source-Clone | npm-Paket @earendil-works/pi-featherless-kali mit kali-ai CLI | | src/handlers/provider.ts | OAuth-style login | API-key provider using $FEATHERLESS_API_KEY; appears under /login -> API keys | | Type-check command | Missing | pnpm tsc --noEmit now works | | Install script | None | install-kali.sh for global source install | | Update script | None | update-kali.sh pulls latest changes, reinstalls, and re-runs tests | | Bundled skills | None | websearch and kali-admin | | Update-Banner | None | Automatische "Update verfügbar"-Meldung oben in der Chat UI | | Code style | File-level JSDoc and section-divider comments | Removed to avoid AI-typical comment patterns |

All functional source logic is preserved 1:1 from the original repository; only imports, provider registration, build/install metadata, CLI helpers, and comments were changed.

Requirements

• Kali Linux (native or WSL)
• Node.js ≥ 20 (so corepack is available)
  sudo apt update && sudo apt install -y nodejs npm
• pnpm (enabled via corepack)
• A Featherless AI API key: https://featherless.ai/account/api-keys

Install via npm

npm install -g @earendil-works/pi-coding-agent
npm install -g @ryukin-dev/pi-featherless-kali

Danach reicht im Terminal:

kaliai

kaliai startet die Chat UI. kaliai Update aktualisiert das Paket.

Direktbefehle

kaliai              # Chat UI starten
kaliai Update       # KaliAI aktualisieren
kaliai whatsnew     # Neueste Änderungen anzeigen

Der Scope ist @ryukin-dev, weil @earendil-works eine fremde npm-Organisation ist.

Install aus dem Source-Repo

chmod +x install-kali.sh
./install-kali.sh          # global install to ~/.pi/agent/extensions/pi-featherless

Project-local install:

./install-kali.sh --project /path/to/your/project

Update eines Source-Installs

chmod +x update-kali.sh
./update-kali.sh

Project-local update:

./update-kali.sh --project /path/to/your/project

Skip verification with --skip-tests; discard local edits with --force.

Verify

cd ~/.pi/agent/extensions/pi-featherless
pnpm test        # vitest — 13 tests should pass
pnpm tsc --noEmit

Quick API test

export FEATHERLESS_API_KEY="sk-..."
pnpm exec tsx test-api.ts ping

Usage in the Pi Chat UI

Because the provider is configured as an API-key provider, it appears under API keys in the login menu.

/login
# Choose API keys -> Featherless AI, then paste your key.

/model zai-org/GLM-5

# Later, clear the stored key with:
/logout

KaliAI-Befehle in der Chat UI

/update             # Auf neueste npm-Version aktualisieren
/whatsnew           # Changelog anzeigen

Wenn ein Update verfügbar ist, erscheint oben in der Chat UI ein Banner mit der neuen Version. Nach dem Update wird das Changelog kurz eingeblendet, bis das Banner verschwindet.

Linux shell helper (kali-sh)

A fixed command-line helper for running Linux commands and managing files without relying on skills:

kali-sh run "ls -la"
kali-sh exec uname -a
kali-sh create /tmp/note.txt "hello world"
echo "data" | kali-sh write /tmp/data.txt
kali-sh delete /tmp/old --yes
kali-sh mkdir /tmp/mydir
kali-sh cat /etc/os-release
kali-sh ls /var/log
kali-sh exists /tmp/note.txt

Mit --json gibt jeder Befehl maschinenlesbares JSON aus.

Bundled skills

• websearch — search the web via Brave (with BRAVE_API_KEY) or DuckDuckGo, and extract readable article text from URLs.
• kali-admin — authorizes the agent to run shell commands, use sudo, install packages with apt, manage services, and use Kali's security tooling.

Troubleshooting

• pnpm: command not found → corepack enable && corepack prepare pnpm@latest --activate
• ERR_PNPM_FETCH_404 @codedoes/pi-featherless → Use this rebuilt copy (self-dependency removed)
• TypeScript missing → pnpm install (typescript/tsx are devDependencies)
• Cannot find module @earendil-works/pi-coding-agent → Install the main agent globally: npm install -g @earendil-works/pi-coding-agent

Original project: CodeDoes/pi-featherless
Rebuild author: Alessandro / RyuKin-Dev