GuruShell — Claude Code for AmigaOS

A native CLI client for Anthropic's Claude API, running directly on your Amiga. No emulation, no MUI dependency — pure AmigaOS 3.2.

What it does

• Stream conversations with Claude AI in real-time with colored markdown output
• Execute AmigaDOS commands, read/write/edit files via tool use with confirmation prompts
• Browse the web and download files over HTTPS using native AmiSSL
• Find files and search text with glob patterns and recursive grep
• Query system info — memory, assigns, volumes, libraries, tasks without shell overhead
• Edit files intelligently with search/replace patching and colored diff preview
• Self-learning agent — saves mistakes to avoid repeating them next session
• Smart compaction — importance-scored history with auto-summary, never forgets your task
• Track costs — dollar amount and API quota shown in title bar
• Pin files to always include in context, even across compaction
• Adaptive performance — scales to your RAM, AMMX acceleration on Vampire
• Save and resume sessions — pick up where you left off
• External prompt file — customize the agent's behavior without recompiling
• Word-wrapped tables — clean aligned tables with bold and code formatting

Requirements

OS	AmigaOS 3.2 or later (Kickstart 47+)
CPU	68020 minimum (A1200 or better)
RAM	8MB+ Fast RAM recommended
Network	Roadshow TCP/IP stack + AmiSSL v5
API Key	From console.anthropic.com
Recommended	ViNCEd shell for scrollback and scrollbars

Tools Available to Claude

shell	Execute AmigaDOS commands (async, timeout, Ctrl-C abort)
read_file	Read file contents (up to 32KB)
write_file	Create or overwrite files (auto .bak backup)
edit_file	Patch files with search/replace (colored diff preview)
web_fetch	Fetch web pages — HTTP + HTTPS, HTML stripped to text
download_file	Download files to disk with progress bar
learn_rule	Save a lesson for future sessions (self-improving)
glob	Find files by pattern (*, **, #? — recursive support)
search	Search text in files or directories (case-insensitive option)
sysinfo	Query memory, assigns, volumes, libraries, running tasks

Commands

/help	Show all commands
/model haiku	Switch model (haiku/sonnet/opus)
/stats	Session statistics
/pin <file>	Pin file to always include in context
/undo	Restore last modified file from .bak
/log	Show tool & thinking activity log
/save / /resume	Save and resume sessions
/learned	Show self-learned rules
/debug	Dump API history to file
Space	Pause streaming (any key to resume)
Ctrl-C	Abort tool execution or API request

Status

Public beta -- free for personal use and evaluation.
GuruShell will become a commercial product at version 1.0.

Disclaimer

This software is provided "as is", without warranty of any kind. The author is not liable for any data loss, damage to hardware or software, loss of profits, or any other damages arising from the use of this software. This software communicates with external API services and can execute commands on your system. You are solely responsible for reviewing and approving all actions performed by the AI agent, and for any costs incurred through API usage. See the included LICENSE file for the full agreement.

Copyright © 2026 Jamil Halabi. All rights reserved.