index-map-py-agent.txt
Rama main · réplica de lectura del repositorio original.
# CODEBASE INDEX MAP | Generated: 2026-10-29 14:22 | Workspace: py-agent | Path: ~/.config/py-agent
# Active symbols and structural connections mapped in the local index.
# -----------------------------------------------------------------------------------------
# Codebase Modules & Active Architecture:
# ├── .gitignore - Secrets & Credentials
# ├── CONTRIBUTING.md - Contributing to Py-Agent
# ├── LICENSE - MODIFIED MIT LICENSE (NON-COMMERCIAL / NO BUSINESS USE)
# ├── README.md - <br>
# ├── SECURITY.md - Security Policy
# ├── ai-agent.py - Py Agent [v0.9.9.64] - Main CLI Runtime, Workspace Agent & Command Dispatcher [CR.01 CO.01]
# ├── ai-context.md - Py-Agent Config
# ├── ai-hook.sh - Production Py-Agent Shell Hook (Sub-Millisecond Startup)(OCR 0.01)
# ├── logo.svg - <svg xmlns="http://www.w3.org/2000/svg" viewBox="121 101 270 310">
# ├── modules/Readme.md - Design & Privacy
# ├── modules/agent_adapters.py - Tool Format Adapters & Self-Healing Parser [CR.01 CO.01]
# ├── modules/agent_chat.py - Unified Agentic Brainstorm, Thinking & Follow-up Recommendation Engine [Production Ready]
# ├── modules/agent_cloud.py - Dynamic Cloud Cascade Engine - Top-down .env & os.environ provider API priority with infinite CUSTOM
# ├── modules/agent_commands.py - Modular Command Dispatcher & Slash Action Registry for Py-Agent [OCR 0.01]
# ├── modules/agent_context.py - Context Search, Indexing & Compaction Engine [OC 0.01]
# ├── modules/agent_core.py - Core Module - Streaming SSE, dynamic tool execution, & Rich rendering [CR.02 CO.01]
# ├── modules/agent_ipython.py - Local-AI Standalone IPython Kernel & RLM Harness Module [OCR 0.01]
# ├── modules/agent_memories.py - Open Knowledge Format (OKF) Project Memory Manager [Production Ready]
# ├── modules/agent_security.py - Zero-Trust Security & Boundary Enforcement Kernel [OCR 0.01]
# ├── modules/agent_sessions.py - SQLite-backed session, checkpoint, and turn logger with sub-agent registry [OCR 0.01]
# ├── modules/agent_skills.py - Unified library & executable for static, dynamic, universal YAML, and on-demand skills [OCR 0.01]
# ├── modules/agent_state.py - State Persistence & Boundary Locking Engine [Hardened Production Ready]
# ├── modules/agent_stream.py - Streaming SSE, ANSI Geometry & Terminal Rendering Engine [CR.02 CO.01]
# ├── modules/agent_tools.py - Native Tool Engine - Handles file editing, search, commands, & graph intelligence [OCR 0.01]
# ├── modules/agent_tts.py - Local-AI Kokoro Text-to-Speech Module [Production Ready]
# ├── modules/agent_tui.py - Production Minimal Textual TUI for Py Agent Engine [Production Ready]
# ├── modules/agent_tui_async.py - Asynchronous uvloop background services for Local-AI Agent TUI [Production Ready]
# ├── modules/agent_ui.py - UI Module - Spinners, session boxes, and interactive menus [CR.01 CO.01]
# ├── modules/agent_vision.py - Vision Module - Multimodal Pre-processing, OCR & Vision Bridge [Production Ready]
# ├── modules/agent_voice.py - Local-AI Standalone Voice to Text Module [Production Ready]
# └── modules/model-select.py - Streamlined TUI Model Selector with Dynamic CUSTOM<N> Discovery [OCR 0.01]
# -----------------------------------------------------------------------------------------
[file:.gitignore] sum:Secrets & Credentials
[file:.thinkrail/context/.gitignore] sum:*
[markdown:CONTRIBUTING.md] title:Contributing to Py-Agent
[file:LICENSE] sum:MODIFIED MIT LICENSE (NON-COMMERCIAL / NO BUSINESS USE)
[markdown:README.md] title:1. Install dependencies (Arch/CachyOS or pip) | links:ai-context.md
[markdown:SECURITY.md] title:Security Policy
[python:ai-agent.py] imp:agent_commands,agent_context,agent_core,agent_memories,agent_sessions,agent_skills,agent_tts,agent_ui,agent_voice,contextlib,json,os,re,readline,shutil,sqlite3,subprocess,sys,tempfile,time | fn:load_env_file,_load_agent_modules,_show_transient_status,_clear_transient_status,workspace_db_counts,ensure_clean_agent_dir,_sweep_dead_session_locks,clean_exit,_launch_surface,resolve_default_profile,run_interactive_chat,run_direct_query,run_matching_search,main
[markdown:ai-context.md] title:Py-Agent Config
[shell:ai-hook.sh] sum:Production Py-Agent Shell Hook (Sub-Millisecond Startup)(OCR 0.01)
[toml:etc/pyproject.toml] sum:[tool.ruff]
[json:etc/pyrightconfig.json] keys:include,exclude,extraPaths,pythonVersion,typeCheckingMode,reportMissingImports,reportMissingTypeStubs,reportOptionalMemberAccess,reportGeneralTypeIssues
[image/svg:logo.svg] dim:38x | size:1.4KB
[markdown:modules/Readme.md] title:Design & Privacy
[python:modules/agent_adapters.py] imp:agent_state,ast,json,os,re,time,typing | fn:_close_unterminated_quote,_strip_line_number_gutters,_extract_diff_hunk,deduplicate_tool_calls,normalize_params,_extract_balanced_json,_parse_heredoc,heal_tool_call,_safe_shell_write,heal_json_args,_extract_ast_python_calls,extract_fallback_tool_calls
[python:modules/agent_chat.py] imp:agent_cloud,agent_ui,json,os,re,sys,urllib | fn:_build_option_placeholders
[python:modules/agent_cloud.py] imp:os,re,typing | fn:_is_valid_key,get_active_configs
[python:modules/agent_commands.py] imp:agent_context,agent_core,agent_ipython,agent_memories,agent_sessions,agent_skills,agent_tts,agent_ui,agent_voice,collections,dataclasses,json,os,re,readline,shutil,subprocess,sys,typing | cls:SessionContext | fn:update_workspace_config,apply_codespace_map,remove_codespace_map,handle_map_toggle,handle_memory_cmd,handle_grounding_cmd,handle_tts_cmd,handle_file_command,handle_hindsight_cmd,dispatch_command
[python:modules/agent_context.py] imp:agent_state,agent_tools,agent_ui,json,os,re,rich,sys,threading,time,typing,urllib | fn:_get_int_env,tokenize,load_context_entries,jaccard_search,clean_tool_prefix,get_accurate_token_count,_get_server_n_ctx,show_memory_status,prune_history
[python:modules/agent_core.py] imp:agent_adapters,agent_cloud,agent_context,agent_ipython,agent_security,agent_state,agent_stream,agent_tools,agent_ui,agent_vision,json,os,re,requests,shutil,subprocess,sys,threading,time,typing,uuid | fn:preprocess_multimodal_messages,describe_image_gemini,_get_img_config,prune_history,_sanitize_tool_history,_get_session,_clean_sigint_handler,_heal_tool_args,run_mod,_log_turn_usage,_calc_turn_tokens,_confirm_gate,_print_tool_output,_run_edit_tool,_backfill_missing_tool_results,agentic_turn,_calc_msg_tokens,_handle_sse_payload,_flush_sse_event,stream_response
[python:modules/agent_ipython.py] imp:IPython,agent_core,agent_memories,agent_security,agent_tools,builtins,collections,contextlib,importlib,io,os,signal,subprocess,sys,threading,time,traceback,typing | cls:CellTimeoutError,MemorySDK,GraphSDK | fn:_timeout_handler,is_ipython_enabled,toggle_ipython_mode,bounded_repr,__init__,search,get_facts,add_fact,__init__,snippet,trace,blast_radius,search,architecture,delegate,_final_answer,_invalidate_module_cache,_init_kernel_sdk,_check_boundary,safe_open,safe_listdir,_read_file,_edit_file,_write_file,_list_dir,_search_code,_run_command,_save_memory_fn,inspect_ast_safety,run_cell,get_active_tools
[python:modules/agent_memories.py] imp:os,re,shutil,sys,tempfile,time,typing | fn:_get_memory_dir,parse_memory_file,get_memory_count,list_memories,get_memory_context,save_memory_file,clear_memories,add_fact,get_facts
[python:modules/agent_security.py] imp:agent_ui,ast,os,re,shlex,sys,typing,urllib | fn:_get_ui,_is_interactive,is_in_system_dir,is_harness_tool,is_outside,resolve_path,_extract_balanced_substitutions,_extract_commands,check_command,_sub_var,check_ast,authorize
[python:modules/agent_sessions.py] imp:agent_context,contextlib,glob,json,os,re,select,sqlite3,subprocess,sys,termios,time,tty,typing | fn:tokenize,_sanitize_workspace,get_key,connect_db,cleanup_all_stale_locks,get_sub_agent_id,cleanup_sub_agent,_is_valid_project_git_repo,create_subagent_worktree,cleanup_subagent_worktree,init_db,save_checkpoint,rollback_checkpoint,log_turn,get_turns_count,clear_turns
[python:modules/agent_skills.py] imp:agent_context,agent_core,agent_security,agent_ui,json,os,re,shlex,shutil,subprocess,sys,typing | fn:ensure_mysys_exists,parse_frontmatter,find_skill_file,load_skill_content,_exec_tool_cmd,run_local_tool,run_interactive_tool,get_system_context,load_skill_blueprints,run_skill_selector
[python:modules/agent_state.py] imp:fcntl,json,os,sys,threading,typing | fn:_get_int_env,get_state,save_state,workspace_safe_name,is_calm_cli
[python:modules/agent_stream.py] imp:agent_state,os,re,rich,shutil,sys,threading,time,typing | cls:TerminalLayout,CleanCodeBlock,AgentMarkdown,_LazyConsole,RichStreamer | fn:__init__,gap,to,record_newlines,reset,_get_code_theme,_get_markdown_class,__rich_console__,Markdown,prepare_markdown,get_cursor_up_count,_get_console,__init__,__getattr__,_escape_markup,__init__,acc_think,acc_ans,_stop_spinner,_stream_think_token,flush_word,_close_think_block,start,update,stop,_process_stream_chunk
[python:modules/agent_tools.py] imp:agent_core,agent_ipython,agent_security,ast,codecs,collections,contextvars,difflib,json,os,re,rich,select,shlex,signal,stat,subprocess,sys,time,typing,urllib | cls:_LazyDiffConsole | fn:print,Syntax,_coerce_bool,get_modified_files,get_read_files,clear_session_tracking,_invalidate_module_cache,_get_int_env,_is_calm,_safe_path,_is_outside_workspace,_check_command_security,_search_codebase,_generate_ast_skeleton,_resilient_replace,run_graph_cmd,run_tool,_in_bounds_gate,_security_gate
[python:modules/agent_tts.py] imp:agent_core,os,re,signal,subprocess,sys,threading,typing | fn:stop_tts,is_tts_enabled,get_tts_speed,set_tts_speed,toggle_tts,clean_text_for_speech,_run_subprocess_safe,speak_text,_run,speak_response
[python:modules/agent_tui.py] imp:agent_adapters,agent_cloud,agent_core,agent_ipython,agent_memories,agent_skills,agent_tools,agent_tts,agent_tui_async,agent_ui,agent_voice,base64,collections,contextlib,json,os,re,requests,rich,shutil,sqlite3,subprocess,sys,textual,threading,time,typing,uvloop | cls:FooterToggle,ImageButton,CloseCardButton,Message,AgentCommandProvider,LocalAITUI | fn:get_tui_state,save_tui_state,format_dir_path,format_model_name,copy_to_clipboard,_glimmer_tui_text,_format_tui_reasonix_text,on_click,on_click,on_click,__init__,update_content,render,search,command_sources,border_accent,is_dark_theme,watch_theme,__init__,on_unmount,_safe_remove_banner,notify,set_skill,set_mode,set_reasoning,action_prompt_image_url,on_key,refresh_db_counts,ensure_system_context,get_db_status_string,update_welcome_banner,compose,action_close_tips_card,on_mount,action_toggle_plan_build,on_input_changed,update_stats_ui,action_scroll_page_up,action_scroll_page_down,action_scroll_up,action_scroll_down,action_copy_last_response,action_copy_entire_chat,handle_view_file,handle_task_command,_sub,handle_slash_command,prompt_tui_confirm,_show,process_query_worker,on_input_submitted,disable_input,enable_input,action_stop_generation,update_sidebar_visibility,action_toggle_sidebar,update_footer_visibility,action_toggle_footer,action_toggle_compact,action_cycle_theme,action_toggle_reasoning,action_toggle_borders
[python:modules/agent_tui_async.py] imp:asyncio,json,os,rich,subprocess | fn:run_async_cmd,watch_workspace_changes,_get_dir_state,start_subagent_ipc_hub,handle_subagent_msg
[python:modules/agent_ui.py] imp:agent_cloud,agent_core,agent_skills,collections,json,os,re,rich,select,shutil,sys,termios,threading,time,tty,typing,urllib | cls:InlineSpinner,CalmBoatSpinner | fn:__init__,_get_theme_color,_glimmer,_spin,update,start,stop,__init__,update_context,update,_sail,start,stop,_read_fd,get_key,get_local_model_name,build_dynamic_box,get_fill,_slab_shader,render_fade_frame,draw_session_box,confirm_tool,run_interactive_selection,show_help,select_workspace_profile
[python:modules/agent_vision.py] imp:base64,ipaddress,json,os,re,socket,typing,urllib | fn:_get_img_config,_is_safe_url,describe_image_gemini,preprocess_multimodal_messages
[python:modules/agent_voice.py] imp:agent_core,base64,http,json,os,re,socket,ssl,subprocess,sys,time,urllib | cls:VoiceHandler | fn:_get_or_create_token,is_bridge_running,load_voice_env,transcribe_gemini,get_prompt_input,log_message,_is_authorized,do_POST,do_GET,run_server,toggle_voice_bridge
[python:modules/model-select.py] imp:asyncio,atexit,copy,json,os,re,select,shutil,socket,subprocess,sys,termios,time,tty,urllib | fn:cleanup_terminal,is_pyrouter_running,start_pyrouter,stop_pyrouter,load_json,save_json,_atomic_write_env,ensure_env_exists,load_env_vars,get_custom_indices,get_provider_keys,get_active_key_set,update_env_multiple,isolate_active_key,deactivate_key,toggle_single_provider,toggle_independent_key,toggle_env_api_keys,detect_provider,parse_endpoint_url,async_fetch_remote,_fetch,async_get_key,_read,prompt_user_input,run_interactive_menu,filter_items,_is_cur,async_main,fmt
[markdown:plugins/Readme.md] title:Plugins: `plugins/`
[markdown:plugins/audio/Readme.md] title:Kokoro Neural Text-to-Speech & Selection Speaker Plugin
[shell:plugins/audio/koko-speak.sh] sum:High-Performance Kokoro Selection Speaker (RAM-disk execution)
[markdown:plugins/brave-suspender/Readme.md] title:Tab Hibernate & Resume (Brave Suspender)
[js:plugins/brave-suspender/background.js]
[json:plugins/brave-suspender/manifest.json] keys:manifest_version,name,version,description,permissions,host_permissions,action,background
[html:plugins/brave-suspender/suspend.html] sum:<!DOCTYPE html>
[js:plugins/brave-suspender/suspend.js]
[python:plugins/burner_mail/burner_mail.py] imp:json,os,pathlib,re,requests,subprocess,textual,time,uuid | cls:EmailItem,BurnerMailApp | fn:ensure_secure_storage,save_secure_session,load_secure_session,purge_secure_session,__init__,compose,__init__,compose,on_mount,action_new_email,action_purge_data,update_email_ui,reset_inbox_ui,action_copy_email,on_button_pressed,trigger_check,check_inbox_worker,add_email_to_list,on_list_view_selected,render_email
[markdown:plugins/dsh/Readme.md] title:DeepSeek Harness (DSH)
[python:plugins/dsh/dsh-bridge.py] imp:agent_adapters,agent_cloud,agent_core,agent_ipython,agent_memories,agent_sessions,agent_skills,agent_tools,agent_tts,json,os,requests,sys,threading,time,typing,uuid | fn:send_rpc_response,send_acp_chunk,validate_workspace,detect_workspace_mode,make_confirm_gate,confirm_gate,assemble_system_prompt,_prune_history,handle_acp_prompt,main
[shell:plugins/dsh/run-dsh.sh] sum:==============================================================================
[markdown:plugins/mcp/PhotoCraft/Readme.md] title:PhotoCraft MCP Integration
[python:plugins/mcp/mcp_client.py] imp:json,os,sqlite3,subprocess,sys,typing | cls:MCPSession | fn:load_dotenv,load_servers_config,_ensure_sqlite_target,__init__,__enter__,__exit__,_send_rpc,_send_notification,_initialize,list_tools,call_tool,run_call,run_list,export_schemas,main
[json:plugins/mcp/servers.json] keys:servers
[markdown:plugins/open-code-optimize/codeoptimize.md] title:Py-Agent Global Architectural Optimization Policy
[json:plugins/open-code-optimize/rule.json] keys:rules
[python:plugins/open-code-optimize/run-optimize] imp:glob,json,os,re,readline,rich,shutil,subprocess,sys,threading,time,typing | cls:TelemetrySpinner | fn:_init_path_completion,_complete_path,_init_budget_completion,_complete_budget,__init__,update,_spin,start,stop,load_env,build_reasoning_payload,sync_ocr_config,parse_action,main
[markdown:plugins/open-code-review/Readme.md] title:Open Code Review
[markdown:plugins/open-code-review/codereview.md] title:Py-Agent Global Architectural Review Policy
[json:plugins/open-code-review/rule.json] keys:rules
[python:plugins/open-code-review/run-review] imp:glob,json,os,re,readline,rich,shutil,subprocess,sys,threading,time,typing | cls:TelemetrySpinner | fn:_init_path_completion,_complete_path,_init_budget_completion,_complete_budget,__init__,update,write_error,_spin,start,stop,load_env,get_active_profile_title,build_reasoning_payload,sync_ocr_config,parse_action,main
[markdown:plugins/openbot/Readme.md] title:OpenBot Integration
[shell:plugins/openbot/launch.sh] sum:set -e
[python:plugins/openbot/pyagent_acp.py] imp:agent_cloud,agent_core,agent_tools,json,os,re,requests,subprocess,sys,uuid | fn:send_rpc,stream_thought,stream_chunk,emit_tool_start,emit_tool_done,parse_tool_calls,execute_tool,run_pyagent_turn,main
[python:plugins/pycode/bridge.py] imp:agent_adapters,agent_cloud,agent_core,agent_ipython,agent_memories,agent_sessions,agent_skills,agent_tools,agent_tts,json,os,requests,sys,threading,time,typing,uuid | fn:send_rpc_response,send_acp_chunk,validate_workspace,detect_workspace_mode,make_confirm_gate,confirm_gate,assemble_system_prompt,_prune_history,handle_acp_prompt,main
[shell:plugins/pycode/launch.sh] sum:==============================================================================
[shell:plugins/pycode/setup.sh] sum:==============================================================================
[markdown:plugins/pykeep/Readme.md] title:PyKeep
[json:plugins/pykeep/pykeep-browser/manifest.json] keys:manifest_version,name,version,description,permissions,action,commands
[html:plugins/pykeep/pykeep-browser/popup.html] sum:<!DOCTYPE html>
[js:plugins/pykeep/pykeep-browser/popup.js]
[ini:plugins/pykeep/pykeep/config.ini] sum:[pykeep]
[python:plugins/pykeep/pykeep/native_host.py] imp:configparser,json,os,pathlib,pykeepass,struct,sys,urllib | fn:get_db_path,read_message,send_message,find_matching_entry,main
[python:plugins/pykeep/pykeep/pykeep.py] imp:configparser,datetime,json,os,pathlib,pykeepass,pyotp,secrets,shutil,string,subprocess,textual,time | cls:CachedItem,SetTotpModal,ConfirmDeleteModal,EditEntryModal,AddEntryModal,PyKeepApp | fn:get_pyotp,__init__,get_saved_theme,save_theme,safe_int,generate_password,create_db_backup,load_config,copy_to_clipboard,extract_totp,get_raw_totp_secret,__init__,compose,on_mount,action_cancel,action_save,__init__,compose,on_mount,action_cancel,action_delete,__init__,compose,on_mount,on_gen_click,action_gen_password,action_cancel,action_save,compose,on_mount,on_gen_click,action_gen_password,action_cancel,action_save,__init__,compose,on_mount,current_accent,unlock,rebuild_cache,refresh_table,filter_search,on_search_enter,row_selected,tick_live_totp,update_inspector,get_current_entry,action_add_entry,handle_entry_added,action_edit_entry,handle_entry_edited,action_delete_entry,handle_entry_deleted,action_set_totp,handle_totp_saved,action_create_backup,action_copy_password,action_copy_username,action_copy_totp,action_open_url,action_focus_search,action_handle_escape,action_cycle_theme
[markdown:plugins/pyrouter/Readme.md] title:OpenCode + PyRouter Setup
[shell:plugins/pyrouter/launch.sh] sum:==============================================================================
[python:plugins/pyrouter/pyrouter.py] imp:http,json,os,random,re,requests,string,sys,time,typing,uuid | cls:RouterHandler,SilentServer | fn:make_canonical_session,load_active_env,resolve_active_upstream,anthropic_to_openai,log_message,_send_cors,do_OPTIONS,do_GET,do_POST,_handle_chat_completions,_handle_messages,_emit_sse,handle_error,main
[markdown:plugins/thinkrail/Readme.md] title:ThinkRail Integration
[shell:plugins/thinkrail/launch.sh] sum:==============================================================================
[python:plugins/thinkrail/thinkrail_bridge.py] imp:agent_cloud,http,json,os,re,requests,sys,time | cls:ThinkRailBridgeHandler | fn:load_pyagent_profile,scrub_payload,log_message,_send_cors,do_OPTIONS,do_POST,do_GET,main
[markdown:plugins/webui/Readme.md] title:WebUI Gateway
[shell:plugins/webui/launch.sh] sum:==============================================================================
[python:plugins/webui/server.py] imp:agent_adapters,agent_core,agent_ipython,agent_memories,agent_sessions,agent_skills,agent_tools,agent_tts,gzip,http,json,os,re,requests,socketserver,sys,urllib | cls:OfficialWebUIProxyHandler,ThreadedProxyServer | fn:detect_workspace_mode,make_confirm_gate,confirm_gate,assemble_system_prompt,_is_origin_allowed,_is_host_allowed,_check_auth,_set_cors_headers,do_OPTIONS,do_GET,do_POST,log_message
[markdown:plugins/yt-transcript/Readme.md] title:YT Transcript to Clipboard
[json:plugins/yt-transcript/manifest.json] keys:manifest_version,name,version,description,permissions,action,commands
[html:plugins/yt-transcript/popup.html] sum:<!DOCTYPE html>
[js:plugins/yt-transcript/popup.js]
[markdown:plugins/zed/Readme.md] title:Py-Agent Zed Integration
[python:plugins/zed/gpui-bridge.py] imp:agent_adapters,agent_cloud,agent_core,agent_memories,agent_skills,agent_tools,json,os,re,requests,sys,threading,time,typing,uuid | fn:log_debug,send_response,send_notification,send_session_update,emit_thought_chunk,emit_message_chunk,emit_tool_call,_request_client_permission,_build_session_context,handle_initialize,handle_session_new,handle_session_load,handle_session_cancel,handle_session_prompt,_worker,_execute_acp_turn,_confirm_gate,main
[shell:setup/Ltiny.sh] sum:==============================================================================
[markdown:setup/Readme.md] title:Local Server Configuration & Model Selector (CPU & GPU Ready)
[shell:setup/flint.sh] sum:==============================================================================
[shell:setup/kat.sh] sum:==============================================================================
[python:setup/model-select-local.py] imp:asyncio,atexit,os,re,select,shutil,subprocess,sys,termios,tty | fn:cleanup_terminal,write_cpu_state,get_memory_info,format_memory_bar,is_target_pid,get_running_instances,is_model_active,async_set_cpu_mode,async_set_cpu_chill,async_set_cpu_balanced,async_stop_all_engines,launch_local_server,async_get_key_with_timeout,_read,draw_menu,async_main
[shell:setup/ornith.sh] sum:==============================================================================
[shell:setup/q2bu.sh] sum:==========================================
[shell:setup/qwen38d.sh] sum:==============================================================================
[shell:setup/sage.sh] sum:==============================================================================
[markdown:skills/Readme.md] title:Skills & Directives
[markdown:skills/hindsight.md] title:HINDSIGHT: RETROSPECTIVE & LESSON COMPILER
[markdown:skills/meta/brainstorm.md] title:[SKILL] brainstorm ---> brainstorm, lateral, creative, perspective, future, trends, macro
[markdown:skills/meta/follow-up.md] title:[SKILL] follow-up ---> follow-up, followup, question, mechanics, practical, compare
[markdown:skills/meta/thinking.md] title:[SKILL] thinking ---> thinking, think, analyze, next-steps, details, critique, risk
[markdown:skills/on-demand/caveman.md] title:[SKILL] Caveman Mode ---> caveman, talk like caveman, caveman-mode, less tokens, be brief
[markdown:skills/on-demand/chat/chat.md] title:chat
[markdown:skills/on-demand/humanizer.md] title:Technical README Humanizer
[markdown:skills/on-demand/i-have-adhd.md] title:ADHD Output Mode
[markdown:skills/on-demand/omarchy/capture.md] title:Screen Capture & Sharing Directives
[markdown:skills/on-demand/omarchy/contributing.md] title:Bug Reporting & Upstream Directives
[markdown:skills/on-demand/omarchy/diagnose-crash.md] title:Crash & Core Dump Diagnosis Directives
[markdown:skills/on-demand/omarchy/hooks.md] title:Automation Hooks Directives
[markdown:skills/on-demand/omarchy/hyprland.md] title:Hyprland Config Directives
[markdown:skills/on-demand/omarchy/omarchy.md] title:Omarchy System Directives
[markdown:skills/on-demand/omarchy/plugins.md] title:Shell, Bar & Plugins Directives
[markdown:skills/on-demand/omarchy/reporting.md] title:Reporting a Crash Upstream to Omarchy
[markdown:skills/on-demand/omarchy/theming.md] title:Theming & Appearance Directives
[markdown:skills/on-demand/pirate.md] title:[SKILL] Pirate Talk ---> pirate, talk like a pirate, pirate-talk, nautical, captain
[markdown:skills/on-demand/ponytail-py.md] title:[SKILL] Ponytail-Py ---> ponytail-py, senior python dev, yagni, minimal python, pythonic simplicity
[markdown:skills/on-demand/ponytail.md] title:[SKILL] Ponytail ---> ponytail, lazy senior dev, yagni, minimal code, simplify code
[markdown:skills/on-demand/pysmol.md] title:[SKILL] PySmol ---> pysmol, smol, smolagents, codeagent, python-loop, batch-code, in-memory-python, code-first
[markdown:skills/profiles/archive/nexn25.md] title:nexn25
[markdown:skills/profiles/archive/occamy.md] title:occamy
[markdown:skills/profiles/cloud.md] title:cloud
[markdown:skills/profiles/deepseek.md] title:deepseek
[markdown:skills/profiles/flint.md] title:flint
[markdown:skills/profiles/katcoder.md] title:katcoder
[markdown:skills/profiles/lfm2.md] title:lfm2
[markdown:skills/profiles/lfm2_24b.md] title:lfm2_24b
[markdown:skills/profiles/lingtiny.md] title:lingtiny
[markdown:skills/profiles/minicpm.md] title:minicpm
[markdown:skills/profiles/ornith.md] title:ornith
[markdown:skills/profiles/photocraft-gem.md] title:photocraft-gem
[markdown:skills/profiles/photocraft-loc.md] title:photocraft-loc
[markdown:skills/profiles/purebash-lfm.md] title:purebash-lfm
[markdown:skills/profiles/purebash-ling.md] title:purebash-ling
[markdown:skills/profiles/q2bu.md] title:q2bu
[markdown:skills/profiles/qwen38d.md] title:qwen38d
[markdown:skills/profiles/sage.md] title:sage
[markdown:skills/profiles/sysadmin.md] title:sysadmin
[markdown:skills/profiles/tielcoder.md] title:tielcoder
[markdown:skills/profiles/tini-cybersec.md] title:tini-cybersec
[markdown:skills/system/aur-audit.md] title:AUR PRE-INSTALL SECURITY AUDIT SKILL
[markdown:skills/system/mysys.md] title:SYSTEM ARCHITECTURE BLUEPRINT
[markdown:skills/system/security-audit.md] title:SYSTEM SECURITY AUDIT DIRECTIVES
[markdown:skills/system/system-optimizer.md] title:GENERAL LINUX DESKTOP OPTIMIZATION SKILL
[markdown:skills/system/update-inspector.md] title:ARCH LINUX UPGRADE DIRECTIVES
[markdown:skills/system_instructions.md] title:Global System Instructions (uncomment rules to activate):
[python:tools/cheatsheet] imp:os,re,rich,sys
[file:tools/email/.email] sum:--- Global fallback connection details ---
[markdown:tools/email/Readme.md] title:Email TUI Monitor: `email-agent`
[python:tools/email/email-agent] imp:agent_ui,concurrent,email,imaplib,os,re,select,sys,termios,tty | fn:_fallback_get_key,get_key,load_email_config,clean_header,highlight_tags,fetch_single_account,fetch_emails,run_interactive_tui,main
[python:tools/evals/eval-stack] imp:agent_adapters,agent_cloud,agent_core,agent_ipython,agent_skills,agent_tools,agent_ui,contextlib,io,json,os,re,rich,select,shutil,subprocess,sys,tempfile,termios,threading,time,tty,typing | cls:MinimalSpinner | fn:__init__,start,_spin,stop,_safe_read,_write_fixture,_verify_python_script,_verify_ag01,_verify_ag02,_verify_ag03,_verify_ag04,_verify_ag05,_verify_ag06,_verify_ag07,list_available_profiles,select_profile_interactive,_get_k,resolve_dynamic_profile,get_current_model_info,_log_failure_trace,run_single_agentic_test,main
[python:tools/generate-profile] imp:contextlib,glob,os,re,shutil,socket,subprocess,sys,typing | fn:clean_str,read_sysfs,run_cmd
[markdown:tools/index-map/Readme.md] title:Codebase Mapping & Relational Knowledge Graph: `index-map`
[python:tools/index-map/index-map] imp:ast,fnmatch,json,os,re,sqlite3,struct,sys,time | cls:PythonGraphVisitor | fn:load_gitignore_patterns,should_ignore,is_binary,get_file_summary,__init__,visit_Import,visit_ImportFrom,visit_ClassDef,visit_FunctionDef,visit_AsyncFunctionDef,visit_any_func,parse_non_python_file,analyze_markdown_file,analyze_image_file,analyze_json_file,analyze_shell_file,analyze_generic_file,init_db,find_db_path,compile_ascii_tree,compile_flat_shorthand,run_indexing,search_symbols,extract_snippet,main
[markdown:tools/loop/Readme.md] title:Autonomous Task Loop Engine (`loop.py`)
[python:tools/loop/loop.py] imp:agent_core,agent_tools,agent_ui,argparse,os,re,sys,time,typing | fn:_read_spec_file,_log_task_turn,is_task_complete,_get_thinking_budget,run_task_loop,tracked_run_tool,main
[python:tools/new-project] imp:contextlib,fcntl,os,re,signal,subprocess,sys,tempfile | fn:prompt_tty,add_to_context_file,create_profile_file,main
[python:tools/omarchy] imp:contextlib,os,re,select,shutil,subprocess,sys,termios,tty,typing | fn:load_wordmark_banner,get_key_non_blocking,pause_terminal,draw_menu,run_skill,main
[python:tools/subsec/apps/media/media.py] imp:math,os,random,re,select,shutil,signal,subprocess,sys,termios,time,tty,unicodedata | cls:VisualizerPhysics,SystemAudio,PlayerManager | fn:strip_ansi,char_display_width,str_display_width,truncate_str_display,fmt_time,__init__,update,render_peak_equalizer,render_braille_spectrogram,render_stereo_vu_deck,make_vu_bar,render_oscilloscope,render_symmetrical_wings,render_cyber_matrix,generate_visualizer_panel,__init__,query,adjust,toggle_mute,__init__,parse_time,find_best_player,update,toggle,next,previous,seek,toggle_shuffle,cycle_loop,get_key_non_blocking,format_row,run_tuiamp,cleanup
[python:tools/subsec/apps/stopwatch/stopwatch.py] imp:math,os,re,select,shutil,signal,sys,termios,time,tty,unicodedata | fn:strip_ansi,char_display_width,str_display_width,truncate_str_display,fmt_time_high_res,fmt_delta,render_radar_sweep,render_chrono_pendulum,render_braille_wave,render_linear_pulse,render_matrix_stream,generate_visualizer_panel,get_key_non_blocking,format_row,run_stopwatch_tui,cleanup
[shell:tools/subsec/apps/stopwatch/stopwatch.sh] sum:Minimalist Pure Bash High-Resolution Stopwatch v2.0
[file:tools/subsec/hyprstate/gitcom] sum:Hyprland Workspace State Manager -- GitCom
[file:tools/subsec/hyprstate/work] sum:Hyprland Workspace State Manager -- Work
[python:tools/system-stack] imp:contextlib,os,re,rich,select,shutil,subprocess,sys,termios,time,tty,typing | fn:check_mysys_drift,get_key_non_blocking,pause_terminal,draw_menu,run_target,main
[markdown:tools/system/Readme.md] title:Readme
[file:tools/system/ai-commit] sum:ai-commit - High-Speed Minimalist Git Commit Generator
[file:tools/system/ai-status] sum:ai-status - Diagnostics for Py-Agent Cloud Models & Quotas
[file:tools/system/aur-audit] sum:aur-audit - Lightweight Zero-Trust AUR Auditor [Local & Cloud Optimized]
[file:tools/system/log-checker] sum:AI Log Triage & Diagnostics (Zero-Config / High-Precision)
[file:tools/system/security-audit] sum:security-audit - Dynamic Security Profile Integrator & System Auditor
[file:tools/system/syscheck] sum:syscheck - Composite System Triage & Diagnostics Orchestrator
[file:tools/system/system-health] sum:system-health - Context-Aware Real-time Hardware Inspector
[file:tools/system/system-optimizer] sum:sysop - Dynamic Optimization & Hardware Profile Integrator
[file:tools/system/update-inspector] sum:AI Update Inspector - Universal Arch Linux & CachyOS
[python:tools/test-agent] imp:agent_adapters,agent_cloud,agent_context,agent_core,agent_ipython,agent_memories,agent_security,agent_sessions,agent_skills,agent_tools,agent_tts,agent_tui,agent_ui,agent_vision,ast,contextlib,glob,importlib,io,json,os,py_compile,re,shutil,subprocess,sys,tempfile,time | cls:ActiveMockSpinner | fn:print_result,mock_gate_deny,__init__,stop
[session:var/.active_sessions/home-j5-.config-py-agent-projects-ling-tiny-1247644.session] sum:0
[file:var/.gitkeep] sum:Empty file
[json:var/.openrouter_cache_v2.json] keys:free,paid,gemini,claude,openai,grok,custom
[pid:var/.pyrouter.pid] sum:33943
[file:var/.request_log] sum:Empty file
[lock:var/.state.lock] sum:Empty file
[json:var/.tui_state.json] keys:compact_mode,sidebar_hidden,footer_hidden,tips_card_hidden,tui_theme,tui_borders_enabled,theme