Interactive TUI

Q: what is 2+2

A: 4

─── Task #1 completed (0.8s, 1 words) ───

# Start interactive mode
praisonai chat

# Or use short flag
praisonai -i

# With a specific model
praisonai chat --llm gpt-4o

# Single prompt with tools, streaming output, no boxes
praisonai "list files in current folder" --chat

# Test web search
praisonai "search the web for AI news" --chat

# Test file operations
praisonai "read the file README.md" --chat

# List available tools
❯ /tools
Available tools: 13
  • acp_create_file, acp_edit_file, acp_delete_file, acp_execute_command
  • lsp_list_symbols, lsp_find_definition, lsp_find_references, lsp_get_diagnostics
  • read_file, write_file, list_files, execute_command, internet_search

# Resume most recent project session
praisonai -c

# Resume a specific session id
praisonai --session abc12345

# Branch it non-destructively
praisonai --fork --session abc12345

# First launch — no flags needed
praisonai
> Hello, help me refactor foo.py
> /quit

# Later, from any terminal
praisonai
> /sessions          # now lists the previous conversation
> /continue          # resumes it

❯ /help

Commands:
  /help          - Show this help
  /exit          - Exit interactive mode
  /clear         - Clear screen
  /continue [id] - Continue most recent session, or a specific session id
  /tools         - List available tools
  /profile       - Toggle profiling (show timing breakdown)
  /model [name]  - Show or change current model
  /stats         - Show session statistics (tokens, cost)
  /compact       - Compact chat_history (auto-runs at the turn boundary too)
  /compact-display - Toggle compact output display (alias /dense)
  /undo          - Undo last turn (files + history when checkpointing on)
  /diff          - Show file changes this session (needs checkpoints.auto)
  /git-status    - Show working-tree status
  /git-diff      - Show the uncommitted diff
  /git-log [n]   - Show recent commits
  /git-commit [m]- Stage and commit (message auto-generated when omitted)
  /git-undo      - Undo the last commit (keeps changes staged)
  /map [path]    - Show the repository map
  /queue         - Show queued messages
  /queue clear   - Clear message queue

@ Mentions:
  @file.txt      - Include file content in prompt
  @src/          - Include directory listing

Features:
  • File operations (read, write, list)
  • Shell command execution
  • Web search
  • Context compression for long sessions
  • Queue messages while agent is processing

# Include a file in your prompt
❯ what does @README.md say about installation?
📄 Included: README.md (2,345 chars)

The README.md file explains that installation can be done via pip...

# Include multiple files
❯ compare @file1.py and @file2.py
📄 Included: file1.py (500 chars)
📄 Included: file2.py (450 chars)

Here are the key differences between the two files...

# Include directory listing
❯ what files are in @src/
📁 Listed: src/ (15 items)

The src/ directory contains the following files...

❯ !git status              # run inline, no model turn
❯ !!git diff               # attach output as context for the next message
❯ summarise the change     # this turn sees the diff

# Show current model
❯ /model
Current model: gpt-4o-mini

Available models (examples):
  • gpt-4o, gpt-4o-mini
  • claude-3-5-sonnet, claude-3-haiku
  • gemini-2.0-flash, gemini-1.5-pro

Usage: /model <model-name>

# Change to a different model
❯ /model gpt-4o
✓ Model changed: gpt-4o-mini → gpt-4o

# Verify the change
❯ /model
Current model: gpt-4o

❯ /stats

Model:          gpt-4o-mini
Total tokens:   3801
Estimated cost: $0.0017

❯ /compact
Compacted context: 240,483 → 94,191 tokens (120 → 47 messages)

❯ write a function to sort a list
[AI generates sorting function]

❯ /undo
✓ Undone last turn
Removed: write a function to sort a list...

❯ /stats
Session Statistics
  ...
  History turns:  8  # Reduced from 10

❯ /undo
Undo: Workspace restored to `a1b2c3d` (turn 3: refactor auth handler).

❯ /revert 3
Reverted 3 turn(s) — files + conversation restored to a1b2c3d.

❯ /revert 9
Can only revert 1..N turn(s).

/diff              # all changes since session start
/diff --turn       # only the last turn's changes (alias: -t)
/diff src/auth.py  # changes to a single file since session start

Workspace checkpointing is disabled, so /diff has no session baseline to compare against.

Enable it with `checkpoints.auto: true` in config or `PRAISONAI_CHECKPOINTS=on`.

# While agent is processing, type more messages
❯ Create a Python function to calculate fibonacci
[Agent processing...]

❯ Add docstrings to the function
❯ Create unit tests

# Check the queue
❯ /queue
⏳ Processing...

Queued Messages (2):
  0. ↳ Add docstrings to the function
  1. ↳ Create unit tests

Use /queue clear to clear, /queue remove N to remove

❯ summarise the whole repo
  ⏳ Praison AI is thinking... (Ctrl-C to interrupt)
^C
  ⏹ Interrupting… (finishing current step)
Turn interrupted by user.

❯ ok, just the README instead

❯ new question
  ⏹ Previous turn is still cancelling; please wait a moment and try again.

❯ /profile
Profiling enabled

❯ what is 2+2
4

─── Profiling ───
Import:      0.1ms
Agent setup: 0.3ms
LLM call:    1,234.5ms
Display:     15.2ms
Total:       1,250.1ms

❯ /profile
Profiling disabled

❯ what is 2+2

4

╭─ Agent Info ─────────────────────────────────────────────╮
│  👤 Agent: DirectAgent                                   │
│  Role: Assistant                                         │
╰──────────────────────────────────────────────────────────╯
╭──────────────────────── Task ────────────────────────────╮
│ what is 2+2                                              │
╰──────────────────────────────────────────────────────────╯
╭─────────────────────── Response ─────────────────────────╮
│ 4                                                        │
╰──────────────────────────────────────────────────────────╯

❯ list files in current folder
⚙ Using list_files...
✓ list_files complete

Here are the files in the current folder:
- README.md
- main.py
- config.yaml

❯ run the command 'rm -rf /'
╭─ 🔒 Tool Approval Required ──────────────────────────────╮
│ Function: execute_command                                │
│ Risk Level: CRITICAL                                     │
╰──────────────────────────────────────────────────────────╯

from praisonai.cli.features import InteractiveTUIHandler

# Create handler
handler = InteractiveTUIHandler()

# Define callbacks
def on_input(text):
    """Handle regular input."""
    return f"You said: {text}"

def on_command(cmd):
    """Handle slash commands."""
    if cmd == "/exit":
        return {"type": "exit"}
    return {"type": "command", "message": f"Executed: {cmd}"}

# Initialize and run
session = handler.initialize(
    on_input=on_input,
    on_command=on_command
)

handler.run()

from praisonai.cli.features.interactive_tui import (
    InteractiveConfig,
    InteractiveTUIHandler
)

config = InteractiveConfig(
    prompt="🤖 >>> ",           # Custom prompt
    multiline=True,             # Enable multi-line input
    history_file="~/.praisonai_history",  # Persistent history
    max_history=1000,           # Max history entries
    enable_completions=True,    # Enable auto-complete
    enable_syntax_highlighting=True,  # Enable highlighting
    vi_mode=False,              # Use emacs keybindings
    auto_suggest=True,          # Show suggestions
    show_status_bar=True,       # Show status bar
    color_scheme="monokai"      # Color theme
)

handler = InteractiveTUIHandler()
session = handler.initialize(config=config)

from praisonai.cli.features.interactive_tui import InteractiveSession

session = InteractiveSession()

# Add slash commands for completion
# Note: Autocomplete only triggers when you type /
session.add_commands(["help", "exit", "cost", "model", "plan", "queue"])

# Add symbols from your codebase
session.add_symbols(["MyClass", "my_function", "CONFIG"])

# Refresh file completions
session.refresh_files(root=Path("/path/to/project"))

from praisonai.cli.features.interactive_tui import HistoryManager

# Create history manager
history = HistoryManager(
    history_file="~/.my_history",
    max_entries=500
)

# Add entries
history.add("first command")
history.add("second command")

# Navigate
prev = history.get_previous()  # "second command"
prev = history.get_previous()  # "first command"
next_cmd = history.get_next()  # "second command"

# Search
results = history.search("/help")  # Find commands starting with "/help"

# Clear
history.clear()

from praisonai.cli.features.interactive_tui import StatusDisplay

display = StatusDisplay(show_status_bar=True)

# Set status items
display.set_status("model", "gpt-4o")
display.set_status("tokens", "1,234")
display.set_status("cost", "$0.05")

# Print formatted output
display.print_welcome(version="1.0.0")
display.print_response("Here's the solution...", title="AI Response")
display.print_error("Something went wrong")
display.print_info("Processing...")
display.print_success("Done!")

config = InteractiveConfig(vi_mode=True)

config = InteractiveConfig(
    prompt="🤖 praisonai> "
)

def get_prompt():
    branch = get_git_branch()
    return f"({branch}) >>> "

# Update prompt dynamically
session.config.prompt = get_prompt()

from prompt_toolkit.styles import Style

custom_style = Style.from_dict({
    'prompt': '#00aa00 bold',
    'input': '#ffffff',
    'completion': 'bg:#333333 #ffffff',
})

# Apply to session
session._prompt_session.style = custom_style

from praisonai.cli.features import (
    InteractiveTUIHandler,
    SlashCommandHandler
)

# Create handlers
tui = InteractiveTUIHandler()
slash = SlashCommandHandler()

def on_command(cmd):
    if slash.is_command(cmd):
        return slash.execute(cmd)
    return None

session = tui.initialize(on_command=on_command)

from praisonai.cli.features import (
    InteractiveTUIHandler,
    CostTrackerHandler
)

tui = InteractiveTUIHandler()
cost = CostTrackerHandler()
cost.initialize()

def on_input(text):
    # Process with AI...
    response = ai.chat(text)

    # Track costs
    cost.track_request("gpt-4o", input_tokens, output_tokens)

    # Update status
    tui._session.display.set_status("cost", f"${cost.get_cost():.4f}")

    return response

session = tui.initialize(on_input=on_input)

# Without prompt_toolkit
>>> (Enter empty line to submit)
Hello, help me with my code

# Basic input still works, just without advanced features

# Install prompt_toolkit
pip install prompt_toolkit

# Verify installation
python -c "import prompt_toolkit; print(prompt_toolkit.__version__)"

# Ensure history file path is writable
config = InteractiveConfig(
    history_file=os.path.expanduser("~/.praisonai_history")
)

# Set terminal type
export TERM=xterm-256color

# Or disable colors
config = InteractiveConfig(enable_syntax_highlighting=False)

# Ensure the file exists and is readable
ls -la @yourfile.txt

# Use absolute paths if relative paths don't work
❯ what does @/full/path/to/file.txt say?

# Check for typos in the path
❯ what does @README.md say?  # Correct
❯ what does @readme.md say?  # Case-sensitive on Linux/Mac

# Run built-in smoke tests
praisonai test interactive --suite smoke

# Run tool-specific tests
praisonai test interactive --suite tools

# Run refactoring workflow tests
praisonai test interactive --suite refactor

# Run multi-agent tests
praisonai test interactive --suite multi_agent

# List available suites
praisonai test interactive --list

# Run custom CSV tests
praisonai test interactive --csv my_tests.csv

# Keep artifacts for debugging
praisonai test interactive --suite tools --keep-artifacts

# Generate CSV template
praisonai test interactive --generate-template

id,name,prompts,expected_tools,expected_files,judge_rubric
test_01,Create File,"Create hello.py with print('hello')",acp_create_file,"{""hello.py"": ""print.*hello""}",File created successfully
test_02,Multi-step,"[""Create test.py"", ""Edit test.py""]","acp_create_file,acp_edit_file",,Files modified correctly

praisonai test interactive [OPTIONS]

Options:
  --csv, -c PATH          Path to CSV test file
  --suite, -s NAME        Built-in suite: smoke, tools, refactor, multi_agent, github-advanced
  --model, -m MODEL       LLM model for agent (default: gpt-4o-mini)
  --judge-model MODEL     LLM model for judge (default: gpt-4o-mini)
  --workspace, -w PATH    Workspace directory
  --artifacts-dir PATH    Directory for artifacts
  --fail-fast, -x         Stop on first failure
  --keep-artifacts        Keep test artifacts
  --no-judge              Skip judge evaluation
  --verbose, -v           Verbose output
  --list                  List available suites
  --generate-template     Generate CSV template

# Run GitHub Advanced tests
PRAISON_LIVE_NETWORK=1 praisonai test interactive --suite github-advanced

# Check prerequisites
gh auth status