# 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 -
# ├── 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 - # ├── 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 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: [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: [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: [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