notes.txt

CyborgShell Release Notes - RELEASE CANDIDATE 12

================================================================================
28th November 2025
================================================================================

Langues:
- Added support for the 3 Nigerian languages: Hausa, Igbo and Yoruba.

================================================================================
27th October 2025
================================================================================

Documentation:
- Online documentation available at https://cyborgshell.com/docs

ChatGPT Enhancements:
- New train command for loading session data into new sessions
- Mix and match previous sessions and files for training
  Examples:
    train transport: cars.txt,trucks.txt
    train mammals: cats.txt,dogs.txt
    train insects: ants.txt,bugs.txt
    train creatures: mammals:,insects:

Multiple Source Files:
- Transformers now support multiple input files
- Example: link 3 1,2 <transformer>
- Note: No spaces allowed in file number lists

New Transformers:
- csvmerge.xfrm - Appends multiple CSV files with same structure
- jsonmerge.xfrm - Merges one or more JSON files
- filediff.xfrm - Outputs differences between 2 source files
- filejoin.xfrm - Joins multiple files (similar to passthrough)
- filestats.xfrm - Outputs statistics of multiple input files
- session.xfrm - Allows session commands (load, save, train) in transformer chains
- template.xfrm - Populates template with JSON values using {{key}} syntax
  Example: link 4 1,2,3 template (file 1=template, files 2,3=JSON data)
- trigger.xfrm - Returns 'GO' to trigger downstream files
  Use case: link 1 5 trigger (triggers file 1 after file 5 is dirty)

================================================================================
20th October 2025
================================================================================

Service Management:
- Switch AI services on the fly from within ChatGPT and RPGGPT
- New commands:
  services - Lists configured services
  service <servicename> - Changes to specified service (claude, gemini, ollama, openai)

================================================================================
18th August 2025
================================================================================

Provider Configuration:
- Transformers can run in parallel or sequential mode (for provider rate limits)
- New mandatory provider parameter for chatgpt and translate transformers
- Use %PROVIDER% placeholder for configured provider
- Session selection added to chatgpt commandline
  Examples:
    link 2 1 chatgpt %PROVIDER% all provided text is a prompt
    link 2 1 chatgpt openai all provided text is a prompt
    link 2 1 chatgpt %PROVIDER% maths: all provided text is a prompt
    link 2 1 chatgpt openai maths: all provided text is a prompt

================================================================================
29th July 2025
================================================================================

File Drop Events:
- Link transformers to file drop events for batch processing
- Syntax: link drop <transformer> [<args>]
- Use cases:
  link drop ocr
  link drop chatgpt %PROVIDER% analyse the code and list bugs
  link drop chatgpt %PROVIDER% document functions with comments
- Tip: Use 'saveall' after dropping files

New Transformers:
- speak.xfrm - Text-to-speech with accent support
  Example translator chain:
    link 2 1 translate %PROVIDER% japanese
    link 3 1 speak accent:ja-jp

================================================================================
28th July 2025
================================================================================

Spaces:
- New public demo space created
- Files moved from public area to demo space

================================================================================
27th July 2025
================================================================================

Configuration:
- New csconfig utility for handler/provider/service configuration

New Transformers:
- ocr.xfrm - OCR for PDFs and images
- blocker.xfrm - Returns nothing if no input
- passthrough.xfrm - Returns all input unchanged

================================================================================
26th July 2025
================================================================================

API Key Storage:
- Store API keys in local storage
- Configuration commands:
  config save <identifier> <value>
  config delete <identifier>

Provider Configuration Examples:
  config save openai-apikey <APIKEY>
  config save openai-endpoint https://api.openai.com/v1/chat/completions
  config save openai-model gpt-4o-mini
  config save ollama-endpoint http://localhost:11434/v1/chat/completions
  config save ollama-model llama3.2:latest

Provider Selection:
  config save chatgpt-provider ollama
  config save translate-provider ollama
  config save ai-provider ollama
  config save ai-handler chatgpt

Local Space:
- New 'local' space for configuration files
- Access with 'cd local' and 'dir' commands
- Switch back with 'cd home' or 'cd public'

AI Handler:
- Use '!' prefix for AI commands (e.g., !what is the meaning of life?)
- Enter '!' alone for help with session management
- Multiple sessions supported with load, save, clear commands
- Sessions saved in currently selected space

================================================================================
25th July 2025
================================================================================

Core Features:
- Run JS files by typing filename (e.g., type 'bm' to run bm.js)
- Transient programs load into file space 0
- Command-line history with up/down arrow navigation
- Dynamic real-time transformers for linked files
- Transformers loaded as editable files
- Project save/load system for files and links
- ChatGPT integration via chatgpt.js

AI Transformers:
- chatgpt.xfrm - AI processing with session management
  Commands:
    AI IGNORE - Prevents AI processing
    AI SESSION CLEAR [<sessionname>] - Clears session memory
    AI SESSION START <sessionname> - Begins session block
    AI SESSION END <sessionname> - Ends session block
    AI PROMPT <sessionname> <prompt> - Creates AI prompt block
    AI PROMPT END <sessionname> - Ends prompt block

- translate.xfrm - Language translation
- null.xfrm - Returns nothing

Enhanced Commands:
- file <filenumber> - Creates files up to specified number
- linkto <sourcefilenumber> <plugin> <arguments>
- link <targetfilenumber> <sourcefilenumber> <plugin> <arguments>
- newfile [<filename>] - Creates file without switching to it
- touch <filenumber> - Manually triggers transformers
- project <projectname> - Creates/loads/saves projects
  project load <projectname>
  project save <projectname>

Examples:
- type ai-example1.txt or ai-example2.txt for transformer chain examples

================================================================================
16th June 2025
================================================================================

Authentication:
- Login with hidden password entry
- Command: login yourusername

================================================================================
15th June 2025
================================================================================

File Type Support:
- MIME type support for text and non-text files
- OCR support for images and PDFs
- OCR creates new files with extracted text
- Type 'ocr' after loading file via drag-and-drop

================================================================================
9th March 2025
================================================================================

File Operations:
- Drag and drop files from computer
- Paste text into line editor
- Auto-numbering for pasted text (preserves existing line numbers)
- File listing shows dirty files (marked with 'D')
- 'saveall' command saves all named files

Programming API:
- api.input() - Get user input
  Example: api.cls(); api.print('enter your name:'); 
           api.input("", function(str_a) { 
               api.print('hello ' + str_a); 
               api.stop(); 
           });

================================================================================
Security Notes
================================================================================

- Do NOT put API keys directly in transformer code
- Fetch API keys from local storage instead
- Consider using local Ollama installation for full security control
- Only run trusted programs to protect API keys
- Permission prompting system coming soon