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