Basic-Agent-Chat-Loop/.chatrc.example at main · Open-Agent-Tools/Basic-Agent-Chat-Loop · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
# AWS Strands Chat Loop Configuration
#
# Copy this file to:
#   ~/.chatrc           (global config for all agents)
#   .chatrc             (project-level config in current directory)
#
# Format: YAML
# Precedence: Project .chatrc > Global ~/.chatrc > Built-in defaults

# ============================================================================
# COLORS - ANSI escape codes for terminal output
# ============================================================================
colors:
  user: '\033[97m'      # Bright white - maximum contrast
  agent: '\033[94m'     # Bright blue
  system: '\033[33m'    # Yellow
  error: '\033[91m'     # Bright red
  success: '\033[92m'   # Bright green
  dim: '\033[2m'        # Dim
  reset: '\033[0m'      # Reset

  # Alternative color schemes (comment/uncomment to switch)
  #
  # Monochrome (for colorblind users):
  # user: '\033[1m'     # Bold
  # agent: '\033[0m'    # Normal
  # system: '\033[2m'   # Dim
  #
  # High contrast:
  # user: '\033[97;1m'  # Bright white bold
  # agent: '\033[96;1m' # Bright cyan bold

# ============================================================================
# FEATURES - Toggle optional functionality
# ============================================================================
features:
  rich_enabled: true            # Use rich library for formatting (if available)
  show_tokens: false            # Display token counts and cost estimates
  show_metadata: true           # Show agent metadata on startup
  readline_enabled: true        # Enable command history with readline

# ============================================================================
# PATHS - File system locations
# ============================================================================
paths:
  save_location: ~/agent-conversations    # Where to save conversations
  log_location: .logs                      # Where to write logs

# ============================================================================
# BEHAVIOR - Runtime behavior settings
# ============================================================================
behavior:
  max_retries: 3               # Maximum retry attempts on failure
  retry_delay: 2.0             # Seconds to wait between retries
  timeout: 120.0               # Request timeout in seconds
  spinner_style: dots          # Thinking indicator style (dots, line, arc, etc.)

# ============================================================================
# UI - User interface preferences
# ============================================================================
ui:
  show_banner: true            # Show welcome banner on startup
  show_thinking_indicator: true  # Show "Thinking..." spinner
  show_duration: true          # Show query duration
  show_status_bar: false       # Show status bar at top (agent, model, queries, time)

# ============================================================================
# SESSIONS - Conversation session management
# ============================================================================
sessions:
  resume_confirmation: true    # Ask for confirmation before resuming a session
  max_sessions: 50             # Maximum number of sessions to keep (auto-cleanup)
  auto_cleanup_days: 30        # Delete sessions older than this many days (0 = never)
  resume_strategy: auto        # Session restore strategy:
                               #   auto   - Try context injection, fallback to replay
                               #   replay - Always replay all queries (slower, works everywhere)
                               # Note: Currently only 'replay' is implemented

# ============================================================================
# PER-AGENT OVERRIDES
# ============================================================================
# Override settings for specific agents by name
# Note: Conversations are always auto-saved to ./.chat-sessions (project-local)
agents:
  # Example: Complex Coding Clara with custom settings
  'Complex Coding Clara':
    model_display_name: 'Claude Sonnet 4.5'  # Override if auto-detection fails
    features:
      show_tokens: true
    ui:
      show_metadata: false    # Hide metadata on startup for cleaner look

  # Example: Product Pete with custom colors
  'Product Pete':
    colors:
      agent: '\033[95m'       # Magenta for Pete

  # Example: Research agents with different settings
  'DeepResearch Dave':
    behavior:
      timeout: 300.0          # Longer timeout for research

# ============================================================================
# USAGE EXAMPLES
# ============================================================================
#
# Global config for all agents:
#   cp .chatrc.example ~/.chatrc
#   edit ~/.chatrc
#
# Project-specific config:
#   cp AWS_Strands/.chatrc.example .chatrc
#   edit .chatrc
#
# Per-agent customization:
#   Add agent name to 'agents' section above
#
# Test your config:
#   python AWS_Strands/chat_loop.py --agent <agent_path>
#