📰 Neuigkeiten
šŸ“– Documentation
×

Documentation

C:\AMIGO> DOCS.EXE /INDEX
Initializing Amigo Documentation... 100%
✔ 13 sections loaded | Version 0.2.0

01 — WHAT IS AMIGO?

Amigo is an AI-powered assistant, specially developed for the Amiga community. It combines cutting-edge AI technology with deep Amiga expert knowledge.

Intelligent Chat
AI with Amiga expertise and RAG knowledge base with thousands of documents
Code Editor
Syntax highlighting for Amiga languages: 68000 ASM, AMOS, Blitz, C, ARexx
Amiga Emulator
WinUAE/AROS integrated directly in the client – run code instantly
Knowledge Base
Custom Chips, hardware, AmigaOS, Workbench, demos, games and history

02 — GETTING STARTED

Get started in three simple steps:

1
Create an Account
Register at retroprojects.de. The FREE plan is immediately available.
2
Choose a Plan
Choose between FREE, BASIC and PRO – depending on your needs. Upgrades are possible at any time.
3
Start Using Amigo
Start a chat with Amigo, browse the Amiga database or try the code editor.

03 — LOGIN AND USER MANAGEMENT

Login

Login is done via your retroprojects.de username and password. Authentication runs securely against the Joomla API.

  • Username – Your retroprojects.de username
  • Password – Your retroprojects.de password
  • "Keep me logged in" – Session persists after browser restart

Create Account

New accounts are created at retroprojects.de. After registration you can immediately log in to the Amigo client.

Token Management

  • JWT token with 24 hour validity
  • Automatic token refresh every 5 minutes
  • Automatic logout when token expires
Login screen in Retro theme

Login screen in Retro theme

04 — CHAT INTERFACE

AI Chat with Amiga Expertise

The chat connects you with an AI specifically trained on Amiga knowledge. It uses a RAG knowledge base (Retrieval-Augmented Generation) with thousands of Amiga documents.

Markdown Rendering

Responses are displayed with full Markdown support:

  • Headings, bold, italic
  • Bullet and numbered lists
  • Code blocks with syntax highlighting
  • Inline code, links, tables and blockquotes

Code Block Action Buttons

Every code block has three action buttons:

Copy
Copy code to clipboard
Editor
Open code directly in the integrated editor
Emulator
Run code in the AROS emulator (for compatible languages)

The Emulator button appears automatically for: Shell/Bash, ASM (68000), C, AMOS Basic, Blitz Basic, ARexx.

Chat interface with sidebar

Chat interface with sidebar

05 — CODE EDITOR

Split View

The editor can be displayed alongside the chat (split mode). This allows you to chat with the AI and edit code simultaneously.

Features

  • Syntax Highlighting – Monaco Editor with Amiga language support
  • Line Numbers – Toggleable
  • Word Wrap – Toggleable
  • Tab Size – Configurable (2, 4, 8)
  • Auto-Save – Automatic saving

Workflow

1
AI generates code
Ask a question in the chat and receive code examples
2
Open in editor
Click "Editor" to open the code in split view
3
Edit
Modify and refine the code
4
Test in emulator
Click "Emulator" to send the code to AmigoOS
Split view: Chat + Editor

Split view: Chat + Editor

06 — EMULATOR INTEGRATION (AmigoOS)

Overview

Amigo comes with an integrated Amiga emulator (WinUAE + AmigoOS/AROS). Code examples from the chat can be executed directly in the emulator – no extra setup needed.

Emulator Widget

The emulator button in the top-right of the toolbar shows the current status:

  • Gray – Emulator stopped
  • Green – Emulator running

Click to open the dropdown panel with model info, start/stop buttons and the work directory with file listing.

Automatic Code Execution – The Pipeline

1
Generate code
AI creates code in the chat
2
Click emulator button
Code block → Emulator button
3
Save script
Script is written to the work directory
4
Generate wrapper
Auto-execute wrapper is created
5
Start emulator
WinUAE starts (or restarts) with AmigoOS
6
Auto-execute
AmigoOS boot sequence runs the script
7
Show result
Execution banner displays status and result

Supported Languages

LanguageExtensionExecution
Shell/Bash.scriptDirect execution via Execute
ASM 68000.asmAssembly via vasm
C.cCompilation via gcc
AMOS Basic.amosAMOS interpreter
Blitz Basic.bb2Blitz compiler
ARexx.rexxARexx interpreter

AmigoOS Specifications

  • A1200 configuration (68030/AGA)
  • 256 MB Z3 RAM
  • Amigo mascot wallpaper
  • Pre-installed development tools
  • Automatic script execution on boot

07 — PROJECTS AND ORGANIZATION

Project System

Chats are organized in projects. By default there is a "General" project.

  • Create new project – Button in the sidebar
  • Switch project – Click on the project selector (dropdown)
  • Manage project – Rename and delete via project settings

Benefits

  • Separate topics (e.g. "Demo Coding", "Game Dev", "Hardware")
  • Separate chat history per project
  • Custom system prompt per project possible

08 — CHAT HISTORY AND CONTEXT MENU

History

All chats are automatically saved and displayed in the sidebar under "History", sorted by date.

Three-Dot Menu

When hovering over a chat entry, a three-dot button appears. Click to open the context menu:

  • Rename – Inline input field, Enter to save
  • Move to project – Sub-menu with all projects
  • Delete – With confirmation prompt

Search

Via "All Chats & Search" in the sidebar you can search all chats – even across projects.

09 — MEMORY SYSTEM

What is Memory?

Memory stores facts and experiences from your conversations. The AI can remember your preferences, projects and previous questions.

Facts
Concrete information, e.g. "User programs in AMOS" or "Favorite computer: A1200"
Experiences
Context from previous conversations for better follow-up answers

Access via "Memory" in the sidebar. Entries can be viewed, edited and deleted.

Memory system

Memory system

10 — CODE SNIPPETS

Snippet Library

Save useful code snippets for later use:

  • New Snippet – Save from chat or editor
  • Categories – Organize by language or topic
  • Favorites – Mark important snippets
  • Search – Quickly find saved snippets

Access via "Snippets" in the sidebar.

11 — SETTINGS AND THEMES

Appearance – Three Themes

Dark Theme
Dark layout with Amiga orange accents – ideal for long sessions
Light Theme
Light layout for daytime workplaces
Retro Theme
Amiga Workbench blue – the authentic Amiga feeling (default!)

Editor Settings

  • Tab size (2, 4, 8 spaces)
  • Word wrap on/off
  • Line numbers on/off
  • Auto-save on/off

Chat Settings

  • Save history on/off
  • Auto-cleanup (old chats after X days)

Emulator Settings

  • Amiga model selection (A500, A500+, A1200, A4000)
  • Use custom WinUAE (configurable path)
Theme selection

Theme selection

12 — AUTO-UPDATE SYSTEM

Automatic Update Check

On startup, the client automatically checks for new versions. The check runs against the retroprojects.de server.

Update Dialog

When an update is available, a dialog appears with:

  • Current and new version number
  • Release notes – What's new?
  • Download size
  • "Download Now" and "Later" buttons

Manual Check

In Settings under "Info" there is a "Check for Updates" button.

Available Platforms

PlatformFormat
WindowsSetup installer (.exe)
LinuxAppImage
AndroidAPK
BrowserAutomatic via retroprojects.de

13 — SUBSCRIPTION MODEL

Available Plans

PlanPriceFeatures
FREE0 €Browse Amiga database, basic search
BASIC15 €/monthFull data access, downloads, Amiga OS access, limited browser AI
PRO25 €/monthEverything in Basic + unlimited AI, desktop client, Android app, code editor, RAG

Badge Display

Your current plan is shown as a colored badge in the bottom-left of the sidebar next to your username.

Feature Unlocking

Different features are unlocked depending on your plan. Upgrades are possible at any time via retroprojects.de.

Amigo - Your Amiga AI Assistant
Version 0.2.0 | 2026 retroprojects.de
Login
✏ Neu registrieren
Newsletter