fixos — API Reference

188 modules | 938 functions | 110 classes

Core (1 modules)
docker (3 modules)
docs (1 modules)
fixos (101 modules)
scripts (2 modules)

Core

`fixos` source

Class	Methods	Description	Source
`AgentReport`	1	—	source
`AutonomousSession`	1	Self-directed autonomous diagnostic and repair session.	source
`FixAction`	0	—	source
`HITLSession`	2	Interactive Human-in-the-Loop diagnostic and repair session.	source
`CmdResult`	1	Result of executed command.	source
`DiagnosticChoice`	0	A diagnosed problem that is selectable but has no executable plan yet.	source
`RemediationAction`	2	One policy-labelled strategy for resolving a diagnostic finding.	source
`OutputFormat`	0	Supported output formats.	source
`OutputFormatter`	9	Centralized output formatter for fixOS CLI commands.	source
`NaturalLanguageGroup`	1	Click group that intelligently handles typos and routes natural language commands to 'ask'.	source
`FixOsConfig`	3	—	source
`DevProjectAnalyzer`	5	Analyze developer projects for dependency folders that can be cleaned.	source
`ProjectDependency`	1	Represents a dependency folder that can be cleaned	source
`DiskAnalyzer`	6	Analyzes disk usage and provides cleanup suggestions	source
`DockerNetworkCleaner`	3	Usuwa wyłącznie sieci bez endpointów i testuje pulę adresową.	source
`DockerStartupOptimizer`	2	Find and explicitly disable stale repository-backed Docker autostart.	source
`FlatpakAnalyzer`	1	Advanced analyzer for Flatpak cleanup decisions	source
`FlatpakItemInfo`	1	Detailed info about a Flatpak item (app, runtime, or data)	source
`FlatpakItemType`	0	—	source
`JetBrainsAiControl`	5	Inspect or explicitly disable AI plugins and stop exact Qoder helpers.	source
`JetBrainsAiSafetyError`	0	Raised when an AI-control target cannot be proven exact and safe.	source
`EdtThreadState`	1	—	source
`JetBrainsDiagnosis`	0	—	source
`JetBrainsLogSignals`	1	—	source
`JetBrainsMetrics`	0	—	source
`JetBrainsRecovery`	3	Correlate JetBrains evidence and optionally run a bounded JVM GC.	source
`JetBrainsRecoveryResult`	0	—	source
`JetBrainsRecoverySafetyError`	0	Raised when a recovery request cannot be proven safe and applicable.	source
`JvmHeapInfo`	1	—	source
`OrphanedWorkloadCleaner`	2	Find and explicitly clean missing-project Docker and process workloads.	source
`OrphanedWorkloadSafetyError`	0	Raised when an exact cleanup target no longer satisfies safety checks.	source
`FileLockWait`	0	One kernel-reported file-lock dependency.	source
`ProcessChainFinding`	2	A fresh process subtree and the evidence associated with it.	source
`ProcessChainInspector`	4	List, analyse and explicitly terminate recent process subtrees.	source
`ProcessChainSafetyError`	0	Raised when a requested process-tree action fails a safety check.	source
`ProcessRecord`	3	Stable process metadata captured at one point in time.	source
`TerminationResult`	1	Result of a dry run or an attempted tree termination.	source
`ProjectArtifact`	0	A single removable artifact directory found inside a project.	source
`CacheRule`	0	—	source
`ServiceCleaner`	19	Plans and executes cleanup of service data.	source
`ServiceDetailsProvider`	1	Provides detailed information about service data.	source
`RiskLevel`	0	How risky it is to delete a scanned service's data.	source
`ServiceDataInfo`	0	Information about service data.	source
`ServiceDataScanner`	5	Scans for large service data directories and allows cleanup.	source
`ServiceType`	0	Service types that can be scanned and cleaned.	source
`StorageAnalyzer`	2	Comprehensive storage analyzer for Linux systems.	source
`StorageItem`	1	Represents a storage item that can be cleaned	source
`EndpointStatus`	1	Permission-safe result of one endpoint observation.	source
`SystemDetector`	1	Detects system parameters.	source
`SystemInfo`	0	Complete system information snapshot.	source
`AuditResult`	3	Result of feature audit - what's installed, what's missing.	source
`FeatureAuditor`	1	Compares installed packages with profile requirements.	source
`PackageCatalog`	4	Manages the package database.	source
`PackageCategory`	0	A category of packages (e.g., core_utils, dev_tools).	source
`PackageInfo`	2	Information about a single package.	source
`FeatureInstaller`	2	Safely installs packages using native package manager or other backends.	source
`UserProfile`	4	A user profile defining what packages/features they want.	source
`FeatureRenderer`	3	Renders audit results for terminal display.	source
`CleanupAction`	0	Represents a cleanup action	source
`CleanupPlanner`	4	Interactive cleanup planning and grouping system	source
`CleanupType`	0	—	source
`Priority`	0	—	source
`CommandExecutor`	6	Bezpieczny executor komend z:	source
`CommandTimeoutError`	0	—	source
`DangerousCommandError`	0	—	source
`ExecutionResult`	2	—	source
`Problem`	2	—	source
`ProblemGraph`	7	DAG problemów systemowych z topological sort do wyznaczania kolejności napraw.	source
`FixOrchestrator`	4	Orkiestrator napraw systemowych.	source
`RollbackEntry`	0	Single recorded operation with its rollback command.	source
`RollbackSession`	5	A session of recorded operations that can be rolled back.	source
`OrphanProjectPinError`	0	Raised when persistent pin state cannot be trusted.	source
`OrphanProjectPins`	4	Read and atomically update exact Compose working-directory pins.	source
`DiagnosticPlugin`	3	Bazowa klasa dla pluginów diagnostycznych fixOS.	source
`DiagnosticResult`	1	Result of a diagnostic plugin run.	source
`Finding`	0	Single finding from a diagnostic plugin.	source
`Severity`	0	Severity level for diagnostic findings.	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`PluginRegistry`	6	Registry for diagnostic plugins with autodiscovery.	source
`Profile`	3	Profil diagnostyczny z zestawem modułów i progów.	source
`LLMClient`	6	Wrapper nad openai.OpenAI kompatybilny z wieloma providerami.	source
`LLMError`	0	Błąd komunikacji z LLM.	source
`LLMAnalysis`	0	Result of LLM analysis	source
`LLMAnalyzer`	4	Uses LLM to analyze disk issues when heuristics aren't sufficient	source
`CommandValidation`	0	Wynik walidacji komendy przez LLM.	source
`FixSuggestion`	0	Pojedyncza sugestia naprawy od LLM.	source
`LLMDiagnosticResponse`	0	Strukturalna odpowiedź LLM na dane diagnostyczne.	source
`NLPIntent`	0	Rozpoznana intencja z polecenia NLP.	source
`RiskLevel`	0	—	source
`AnonymizationContext`	3	Memory-only alias state. Never include this object in LLM payloads.	source
`AnonymizationReport`	2	Raport anonimizacji – co zostało zmaskowane.	source
`ResolutionError`	0	Raised when an anonymized alias cannot be resolved safely.	source
`SessionTimeout`	0	Wyjątek rzucany po przekroczeniu limitu czasu sesji.	source
`SearchResult`	0	—	source
`WatchDaemon`	2	Daemon wykonujący cykliczną diagnostykę z powiadomieniami.	source

HITLSession methods:

remaining() — Get remaining session time in seconds.
run() — Run the HITL session.

OutputFormatter methods:

from_flags(cls, yaml_output, json_output) — Create formatter from CLI flag values. YAML takes precedence over JSON.
status(msg, fg, bold) — Print a status/progress message. Goes to stderr in machine mode.
progress(name, desc) — Print a progress line for diagnostic module collection.
banner(text) — Print banner. Suppressed in machine mode.
emit(data, stream) — Emit structured data to stdout in the configured format.
format_data(data) — Format data dict/list as string in the configured format.
format_diagnostics(data) — Format full diagnostic result with metadata envelope.
format_scan_result(data) — Format scan results with optional disk analysis.

FixOsConfig methods:

load(cls) — Tworzy konfigurację z połączonych źródeł.
validate() — Zwraca listę błędów walidacji (pusta = OK).
summary() — Krótkie podsumowanie konfiguracji (bez klucza API).

DevProjectAnalyzer methods:

analyze(max_depth) — Scan home directory for dependency folders.
get_old_dependencies(days) — Get dependencies not modified in X days
get_large_dependencies(min_size_mb) — Get dependencies larger than X MB
get_summary() — Get human-readable summary
get_cleanup_commands() — Get cleanup commands for each dependency

DiskAnalyzer methods:

analyze_disk_usage(path) — Comprehensive disk usage analysis
get_large_files(path, min_size_mb, max_files) — Find large files
get_cache_dirs(path, max_dirs) — Find cache directories
get_log_dirs(path, max_dirs) — Find log directories
get_temp_dirs(path, max_dirs) — Find temporary directories
suggest_cleanup_actions(path) — Generate cleanup suggestions using heuristics

DockerNetworkCleaner methods:

list_unused(min_age_days) — Zwróć niestandardowe sieci bez endpointów.
probe_address_pool() — Utwórz i usuń tymczasową sieć, potwierdzając dostępność puli.
cleanup() — Usuń dokładnie wykryte sieci i opcjonalnie sprawdź pulę adresową.

DockerStartupOptimizer methods:

scan(min_inactive_days) — Return evidence and stale candidates without changing Docker state.
optimize(container_ids) — Disable exact stale candidates and optionally stop them.

JetBrainsAiControl methods:

find_qoder_helpers(records)
find_config_dirs(records, explicit)
status()
disable_plugins(config_dir)
stop_qoder_helpers(identities)

JetBrainsRecovery methods:

find_main_processes(records)
diagnose(pid)
recover(diagnosis) — Optionally run GC.run and verify evidence without closing the IDE.

OrphanedWorkloadCleaner methods:

scan() — Return exact orphan evidence without changing Docker or processes.
cleanup() — Revalidate and apply only exact selected orphan candidates.

ProcessChainInspector methods:

snapshot()
list_recent() — Return newest processes first, without classifying them as blockers.
find_suspicious_chains() — Reconstruct fresh trees and attach explainable blocking evidence.
terminate_chain(finding) — Terminate one selected tree after identity and ancestry checks.

ProcessRecord methods:

age_seconds(now)
to_dict()

ServiceCleaner methods:

docker_old_unused_until_hours(days) — Convert a positive day count to Docker until=<Nh> hours.
get_docker_old_unused_command(days) — Bounded prune: unused images (and old build cache) older than N days.
list_ollama_models() — Return installed Ollama models with name/size/modified_at (UTC).
list_running_ollama_models() — Names of models currently loaded in memory (must not be deleted).
select_old_ollama_models(models, days) — Filter models whose modified_at is older than N days; skip running ones.
cleanup_ollama_old_unused(days, dry_run) — Remove Ollama models not modified for more than N days (skip running).
get_docker_unused_command() — Prune all unused images and rebuildable build cache (no age filter).
cleanup_docker_unused(dry_run) — Remove unused images/cache and optionally orphaned networks.
cleanup_docker_networks(days, dry_run) — Remove unused custom networks and verify Docker address-pool allocation.
cleanup_docker_old_unused(days, dry_run) — Remove old images/cache and optionally orphaned networks.
build_safe_age_actions(selected_services) — Bounded age-based cleanups treated as safe (option [1] in interactive cleanup).
get_cleanup_plan(selected_services) — Generate cleanup plan for services, split into 3 risk tiers.
cleanup_service(service_type, dry_run, planned_service) — Execute cleanup for a specific service or exact planned entry.
get_risk_level(service_type, path) — Classify cleanup risk for a service path.
is_safe_cleanup(service_type, path) — Backward-compatible bool view of get_risk_level() == SAFE.
get_cleanup_hints(service_type, size_gb) — Get helpful hints for cleaning services that require manual review.
get_service_description(service_type) — Get description for service type.
get_cleanup_command(service_type, path) — Get a bounded cleanup command for a scanned service path.
get_preview_command(service_type, path) — Get preview command for service.

ServiceDataScanner methods:

scan_all_services() — Scan all known services for data above threshold.
scan_service(service_type) — Scan specific service type for data.
measure_service_size_mb(service_type, path) — Measure a service with the same source before and after cleanup.
get_cleanup_plan(selected_services) — Generate cleanup plan for services.
cleanup_service(service_type, dry_run, planned_service) — Execute cleanup for a specific service.

StorageAnalyzer methods:

analyze_full() — Run full system storage analysis
get_summary() — Get human-readable summary

PackageCatalog methods:

load(cls, data_dir) — Load package catalog from YAML files.
get_package(pkg_id) — Get package by ID.
get_packages_by_category(category) — Get all packages in a category.
list_categories() — List all category IDs.

PackageInfo methods:

get_distro_name(distro) — Get package name for specific distro.
is_available_on(distro) — Check if package is available on given distro.

FeatureInstaller methods:

install(packages) — Install a list of packages.
get_rollback_commands(installed_packages) — Generate rollback commands for installed packages.

UserProfile methods:

load(cls, profile_name, data_dir) — Load a profile from YAML file.
list_available(cls, data_dir) — List available profile names.
resolve_packages(catalog, system_info) — Resolve all packages for this profile based on system.
to_dict() — Convert to dictionary.

FeatureRenderer methods:

render_audit(result) — Render complete audit results.
render_package_list(packages, title) — Render a list of packages.
render_system_info(system) — Render system information.

CleanupPlanner methods:

group_by_category(suggestions) — Group cleanup suggestions by category
prioritize_actions(grouped_actions) — Create prioritized list of all actions
create_cleanup_plan(suggestions) — Create comprehensive cleanup plan
interactive_selection(plan) — Interactive selection process (simulated for now)

CommandExecutor methods:

is_dangerous(command) — Sprawdza czy komenda jest potencjalnie destruktywna.
needs_sudo(command)
add_sudo(command)
check_idempotent(command) — Zwraca komendę sprawdzającą stan (jeśli znana), None jeśli nie dotyczy.
execute_sync(command, timeout, add_sudo, check_idempotent) — Synchroniczne wykonanie komendy.
execute(command, timeout, add_sudo) — Asynchroniczne wykonanie komendy.

Problem methods:

is_actionable()
to_summary()

ProblemGraph methods:

add(problem)
get(problem_id)
next_actionable() — Zwraca pierwszy problem bez nierozwiązanych zależności.
all_done()
pending_count()
summary()
render_tree() — Renderuje drzewo problemów jako tekst.

FixOrchestrator methods:

load_from_diagnostics(diagnostics) — Parsuje dane diagnostyczne przez LLM i buduje graf problemów.
load_from_dict(problems_data) — Ładuje problemy bezpośrednio z listy dict (bez LLM).
run_sync(confirm_fn, progress_fn) — Synchroniczna pętla napraw (dla trybu HITL).
run_async(confirm_fn, progress_fn) — Asynchroniczna wersja run_sync.

RollbackSession methods:

record(command, rollback_cmd, stdout, stderr, ...) — Zapisz wykonaną operację.
get_rollback_commands() — Zwraca listę (komenda, rollback) w odwróconej kolejności.
rollback_last(n, dry_run) — Cofnij ostatnich n operacji.
load(cls, session_id) — Załaduj sesję z pliku.
list_sessions(cls, limit) — Lista ostatnich sesji rollback.

OrphanProjectPins methods:

list() — Load validated records, failing closed if the state is malformed.
paths() — Return exact normalized paths used by the scanner.
pin(value) — Persist one exact path and report whether state changed.
unpin(value) — Remove one exact path, leaving unrelated pins untouched.

DiagnosticPlugin methods:

diagnose() — Wykonaj diagnostykę i zwróć wynik.
can_run() — Czy plugin może działać na aktualnej platformie?
get_metadata()

PluginRegistry methods:

discover() — Odkrywanie pluginów przez builtin + entry_points.
register(plugin) — Ręczna rejestracja pluginu.
list_plugins(runnable_only) — Lista zarejestrowanych pluginów.
get_plugin(name) — Pobierz plugin po nazwie.
run(modules, progress_callback) — Uruchom diagnostykę dla wybranych (lub wszystkich) modułów.

Profile methods:

load(cls, name) — Załaduj profil — najpierw user, potem builtin.
list_available(cls) — Lista dostępnych profili (builtin + user).
to_dict()

LLMClient methods:

chat(messages) — Wysyła wiadomości do LLM i zwraca odpowiedź jako string.
chat_stream(messages) — Generator streamujący tokeny odpowiedzi.
chat_structured(messages, response_model) — Wywołanie LLM z wymuszonym schematem JSON (Pydantic model).
ping() — Sprawdza czy API odpowiada (krótki test).

LLMAnalyzer methods:

analyze_disk_issues(disk_data) — Use LLM to analyze disk issues when heuristics are insufficient
analyze_failed_action(action, error) — Analyze failed cleanup action and suggest alternatives
analyze_complex_pattern(pattern_data) — Analyze complex disk usage patterns that heuristics can't categorize
enhance_heuristics_with_llm(heuristic_suggestions, disk_data) — Enhance heuristic suggestions with LLM insights

AnonymizationContext methods:

bind(category, original, token)
numbered_alias(category, original)
user_alias(username)

AnonymizationReport methods:

add(category, count)
summary()

WatchDaemon methods:

run() — Główna pętla monitorowania.
stop() — Zatrzymaj daemon.

Function	Signature	CC	Description	Source
`run_autonomous_session`	`run_autonomous_session(diagnostics, config, show_data, max_fixes)`	1	Uruchamia autonomiczny tryb agenta.	source
`run_autonomous_session`	`run_autonomous_session(diagnostics, config, show_data, max_fixes)`	1	Run autonomous session (backward compatible wrapper).	source
`get_remaining_time`	`get_remaining_time(session)`	2	Calculate remaining session time in seconds.	source
`run_hitl_session`	`run_hitl_session(diagnostics, config, show_data)`	1	Run interactive HITL session with full transparency.	source
`run_hitl_session`	`run_hitl_session(diagnostics, config, show_data)`	1	Run interactive HITL session (backward compatible wrapper).	source
`extract_diagnostic_choices`	`extract_diagnostic_choices(reply)`	12 ⚠️	Extract non-executable choices from numbered diagnosis headings.	source
`extract_fixes`	`extract_fixes(reply)`	4	Extract (command, comment) pairs from LLM reply.	source
`extract_remediation_actions`	`extract_remediation_actions(reply)`	4	Parse a closed remediation plan, falling back to legacy command syntax.	source
`extract_search_topic`	`extract_search_topic(llm_reply)`	3	Extract search keywords from LLM reply.	source
`select_recommended_actions`	`select_recommended_actions(actions)`	4	Return at most one recommended strategy for each finding.	source
`strip_remediation_plan`	`strip_remediation_plan(reply)`	1	Hide the machine plan block from the human-readable diagnosis.	source
`transform_remediation_commands`	`transform_remediation_commands(action, transform)`	4	Apply anonymization reversal to executable fields only.	source
`handle_cleanup_intent`	`handle_cleanup_intent(messages)`	1	Ask for a cleanup plan without authorizing or executing any command.	source
`handle_describe_problem`	`handle_describe_problem(messages, ask_fn)`	2	Handle [D] Describe own problem command.	source
`handle_direct_command`	`handle_direct_command(user_in, messages, executed, run_cmd_fn)`	1	Handle [!cmd] Direct command execution.	source
`handle_execute_all`	`handle_execute_all(fixes, messages, executed, run_cmd_fn)`	17 ⚠️	Handle [A] Execute all commands.	source
`handle_fix_by_number`	`handle_fix_by_number(user_in, fixes, messages, executed, ...)`	9	Handle [N] Execute specific fix by number.	source
`handle_free_text`	`handle_free_text(user_in, messages)`	1	Handle free text input → send to LLM.	source
`handle_quit`	`handle_quit()`	1	Handle [Q] Quit command. Returns False to exit loop.	source
`handle_search`	`handle_search(user_in, messages, serpapi_key)`	2	Handle [search ] Web search command.	source
`handle_skip_all`	`handle_skip_all(messages)`	1	Handle [S] Skip all command.	source
`is_cleanup_intent`	`is_cleanup_intent(user_in)`	2	Recognize a bounded single-word spelling variant of `cleanup`.	source
`parse_user_input`	`parse_user_input(user_in, fixes, messages, executed, ...)`	10	Parse user input and execute appropriate handler.	source
`run_single_command`	`run_single_command(cmd, comment)`	5	Run a command with full transparency and safety checks.	source
`ask_execute_prompt`	`ask_execute_prompt()`	1	Ask user if they want to execute a command.	source
`ask_low_confidence_search`	`ask_low_confidence_search()`	1	Ask user if they want to search when LLM is uncertain.	source
`ask_send_data`	`ask_send_data()`	1	Ask user if they want to send data to LLM.	source
`ask_user_problem`	`ask_user_problem()`	2	Interactively asks the user to describe their problem.	source
`clear_thinking`	`clear_thinking()`	1	Clear the 'Analyzing...' indicator.	source
`fmt_time`	`fmt_time(s)`	1	Format seconds as HH:MM:SS.	source
`get_user_input`	`get_user_input(remaining)`	2	Get user input with prompt.	source
`print_action_menu`	`print_action_menu(fixes, remaining, total_tokens, completed_count)`	19 ⚠️	Print the refreshed interactive menu of remaining choices.	source
`print_blocked_command`	`print_blocked_command(cmd, reason)`	1	Print blocked dangerous command warning.	source
`print_cmd_preview`	`print_cmd_preview(cmd, comment)`	1	Shows command in a clear block before execution.	source
`print_cmd_result`	`print_cmd_result(result)`	8	Shows command result with colorized markdown.	source
`print_executing_all`	`print_executing_all(count)`	1	Print executing all recommended command sets message.	source
`print_invalid_option`	`print_invalid_option(user_in, max_option)`	1	Print invalid option message.	source
`print_llm_error`	`print_llm_error(e)`	1	Print LLM error message.	source
`print_llm_reply`	`print_llm_reply(reply)`	1	Render LLM reply with markdown formatting.	source
`print_no_commands`	`print_no_commands()`	1	Print no commands available message.	source
`print_no_results`	`print_no_results()`	1	Print no search results message.	source
`print_searching`	`print_searching()`	1	Print searching message.	source
`print_select_one`	`print_select_one()`	1	Explain that diagnosis-only choices must be focused individually.	source
`print_session_ended`	`print_session_ended()`	1	Print session ended message.	source
`print_session_header`	`print_session_header(os_info, pkg_manager, model, timeout, ...)`	1	Print session header with system info.	source
`print_session_interrupted`	`print_session_interrupted()`	1	Print session interrupted message.	source
`print_session_summary`	`print_session_summary(messages_count, elapsed, total_tokens, executed)`	3	Print session summary.	source
`print_thinking`	`print_thinking()`	1	Print 'Analyzing...' indicator.	source
`print_timeout`	`print_timeout()`	1	Print session timeout message.	source
`suspend_timeout`	`suspend_timeout()`	4	Context manager to temporarily suspend session timeout during user input.	source
`anonymize`	`anonymize(data_str)`	1	Keep the original string-only return shape used by `llm_shell`.	source
`get_sensitive_values`	`get_sensitive_values()`	1	Return legacy key names without maintaining a second privacy policy.	source
`ask`	`ask(prompt, dry_run)`	1	Wykonaj polecenie w języku naturalnym.	source
`cleanup_services`	`cleanup_services(threshold, services, json_output, cleanup, ...)`	56 ⚠️	Skanuje i czyści dane usług przekraczające próg.	source
`config`	`config()`	1	Zarządzanie konfiguracją fixOS.	source
`config_init`	`config_init(force)`	3	Zainicjalizuj plik konfiguracyjny .env.	source
`config_model`	`config_model(provider)`	8	Interaktywnie wybierz model LLM z listy.	source
`config_provider`	`config_provider()`	6	Interaktywnie wybierz providera LLM z listy.	source
`config_set`	`config_set(key, value)`	2	Ustaw wartość konfiguracyjną w .env.	source
`config_show`	`config_show()`	4	Pokaż aktualną konfigurację.	source
`features`	`features()`	1	Zarządzanie pakietami komfortu systemu.	source
`features_audit`	`features_audit(profile, json_output)`	4	Sprawdź brakujące pakiety dla profilu.	source
`features_install`	`features_install(profile, dry_run, yes, category)`	7	Zainstaluj brakujące pakiety dla profilu.	source
`features_profiles`	`features_profiles()`	3	Lista dostępnych profili.	source
`features_system`	`features_system()`	1	Pokaż wykryty system.	source
`execute_cleanup_actions`	`execute_cleanup_actions(actions, cfg, llm_fallback)`	6	Execute cleanup actions with safety checks	source
`fix`	`fix(provider, token, model, no_banner, ...)`	13 ⚠️	Przeprowadza pełną diagnostykę i uruchamia sesję naprawczą z LLM.	source
`handle_disk_cleanup_mode`	`handle_disk_cleanup_mode(disk_analysis, cfg, dry_run, interactive, ...)`	13 ⚠️	Handle disk cleanup mode with interactive planning	source
`try_llm_fallback_for_failures`	`try_llm_fallback_for_failures(failed_actions, cfg)`	3	Try to fix failed actions using LLM	source
`history`	`history(limit, json_output)`	5	Historia napraw fixOS.	source
`ai_control`	`ai_control(config_dir, disable_plugins, stop_qoder, apply, ...)`	23 ⚠️	Diagnozuj i ogranicz dodatki AI bez zamykania okien IDE.	source
`doctor`	`doctor(pid, minutes, no_thread_dump, json_output, ...)`	25 ⚠️	Zbierz metryki JVM, stan EDT i sygnały z idea.log.	source
`jetbrains`	`jetbrains()`	1	Diagnozuj współdzieloną JVM JetBrains bez zamykania okien.	source
`cli`	`cli(ctx, dry_run, interactive_mode, version)`	7	fixos – AI-powered diagnostyka i naprawa Linux, Windows, macOS.	source
`main`	`main()`	1	Entry point for fixOS CLI.	source
`orchestrate`	`orchestrate(provider, token, model, no_banner, ...)`	13 ⚠️	Zaawansowana orkiestracja napraw z grafem problemów.	source
`profile`	`profile()`	1	Zarządzanie profilami diagnostycznymi.	source
`profile_list`	`profile_list()`	4	Pokaż dostępne profile diagnostyczne.	source
`profile_show`	`profile_show(name)`	4	Pokaż szczegóły profilu diagnostycznego.	source
`projects_cmd`	`projects_cmd(path, threshold, stale_days, only_stale, ...)`	24 ⚠️	Skanuje projekty deweloperskie (np. ~/github//) w poszukiwaniu	source
`llm_providers`	`llm_providers(free)`	6	Lista dostępnych providerów LLM.	source
`providers`	`providers()`	4	Lista providerów LLM z oznaczeniem FREE/PAID.	source
`test_llm`	`test_llm(provider, token, model, no_banner)`	9	Test połączenia z LLM.	source
`quick`	`quick(hours, json_output, deep, no_save)`	11 ⚠️	Natychmiastowa analiza CPU, RAM, dysku, cache i ostatnich przyrostów.	source
`render_quick_snapshot`	`render_quick_snapshot(snapshot)`	25 ⚠️	Render the quick snapshot in a stable, readable form.	source
`quickfix`	`quickfix(dry_run, modules)`	12 ⚠️	Natychmiastowe naprawy bez API — baza znanych bugów.	source
`report`	`report(output_format, output, modules, profile)`	5	Eksport wyników diagnostyki do raportu HTML/Markdown/JSON.	source
`rollback`	`rollback()`	1	Zarządzanie cofaniem operacji fixOS.	source
`rollback_list`	`rollback_list(limit)`	3	Pokaż historię sesji naprawczych.	source
`rollback_show`	`rollback_show(session_id)`	5	Pokaż szczegóły sesji rollback.	source
`rollback_undo`	`rollback_undo(session_id, last, dry_run)`	7	Cofnij operacje z podanej sesji.	source
`scan`	`scan(modules, output, show_raw, no_banner, ...)`	11 ⚠️	Przeprowadza diagnostykę systemu.	source
`add_common_options`	`add_common_options(fn)`	2	Decorator adding common LLM options to a Click command.	source
`add_shared_options`	`add_shared_options(func)`	1	Shared options for both scan and fix commands.	source
`get_banner`	`get_banner()`	1	Return the CLI banner with the installed package version.	source
`get_command_completer`	`get_command_completer()`	1	Build a nested completer for all fixOS commands and common options.	source
`print_interactive_menu`	`print_interactive_menu()`	2	Display the interactive quick menu.	source
`run_interactive_shell`	`run_interactive_shell(ctx)`	16 ⚠️	Run the main interactive prompt loop.	source
`shell_cmd`	`shell_cmd(ctx)`	1	Uruchom interaktywny shell fixOS z menu i autouzupełnianiem TAB.	source
`token`	`token()`	1	Zarządzanie tokenem API.	source
`token_clear`	`token_clear(env_file)`	3	Usuń token z pliku .env.	source
`token_set`	`token_set(key, provider, env_file)`	7	Zapisz token API do pliku .env.	source
`token_show`	`token_show()`	2	Pokaż obecny token (masked).	source
`watch`	`watch(interval, modules, alert_on, max_iterations)`	2	Monitorowanie systemu w tle z powiadomieniami.	source
`detect_provider_from_key`	`detect_provider_from_key(key)`	3	Wykrywa provider na podstawie prefiksu klucza API.	source
`get_providers_list`	`get_providers_list()`	3	Zwraca listę providerów jako listę słowników.	source
`interactive_provider_setup`	`interactive_provider_setup()`	1	Interaktywny wybór providera gdy brak konfiguracji.	source
`interactive_provider_setup`	`interactive_provider_setup()`	5	Interaktywny wybór providera gdy brak konfiguracji.	source
`discover_additional_caches`	`discover_additional_caches(get_size_mb, threshold_mb, covered_paths)`	5	Discover large caches not already covered by known service scanners.	source
`is_generic_cache_safe`	`is_generic_cache_safe(path)`	2	Heuristic safety check for unknown cache directories.	source
`normalize_path`	`normalize_path(path)`	1	—	source
`path_is_covered`	`path_is_covered(path, covered_paths)`	5	Return True when path is already represented by a known service scan.	source
`diagnose_audio`	`diagnose_audio()`	1	Diagnostyka dźwięku (ALSA/PipeWire/PulseAudio/SOF).	source
`diagnose_files`	`diagnose_files()`	4	Diagnostyka plików użytkownika.	source
`diagnose_hardware`	`diagnose_hardware()`	1	Diagnostyka sprzętu laptopa/desktopa (ACPI, kamera, touchpad, DMI).	source
`diagnose_packages`	`diagnose_packages()`	4	Diagnostyka zainstalowanych pakietów i środowiska.	source
`diagnose_resources`	`diagnose_resources()`	13 ⚠️	Diagnostyka zasobów systemowych.	source
`diagnose_security`	`diagnose_security()`	4	Diagnostyka bezpieczeństwa systemu i sieci.	source
`diagnose_storage`	`diagnose_storage()`	4	Diagnostyka optymalizacji dysków i partycji.	source
`diagnose_system`	`diagnose_system()`	11 ⚠️	System metrics – cross-platform: CPU, RAM, disks, processes.	source
`diagnose_thumbnails`	`diagnose_thumbnails()`	1	Diagnostyka podglądów plików (thumbnails) w system.	source
`main`	`main()`	1	Test the disk analyzer	source
`analyze_flatpak_for_cleanup`	`analyze_flatpak_for_cleanup()`	1	Convenience function to run full Flatpak analysis	source
`analyze_idea_log`	`analyze_idea_log(text)`	15 ⚠️	Extract bounded, explainable stall signals from JetBrains log text.	source
`collect_jetbrains_metrics`	`collect_jetbrains_metrics(pid)`	2	—	source
`is_main_jetbrains_process`	`is_main_jetbrains_process(process)`	1	Return true only for a main IDE process, never a helper/server.	source
`jetbrains_product_marker`	`jetbrains_product_marker(process)`	9	Identify a product only from its launcher, never arbitrary arguments.	source
`parse_edt_thread`	`parse_edt_thread(text)`	7	Extract the AWT event-dispatch thread from a `Thread.print` result.	source
`parse_heap_info`	`parse_heap_info(text)`	2	—	source
`read_log_since`	`read_log_since(path, offset)`	3	—	source
`read_log_tail`	`read_log_tail(path)`	2	—	source
`collect_processes`	`collect_processes()`	13 ⚠️	Collect a best-effort process snapshot using the existing psutil dependency.	source
`parse_proc_locks`	`parse_proc_locks(text)`	8	Parse blocked lock requests from Linux `/proc/locks` content.	source
`read_linux_lock_waits`	`read_linux_lock_waits(path)`	2	Read Linux lock dependencies; return no evidence on other/denied systems.	source
`discover_project_roots`	`discover_project_roots(base, max_depth)`	9	Find developer project roots under `base` (dirs carrying a known	source
`find_duplicate_venvs`	`find_duplicate_venvs(artifacts)`	5	Project paths that carry more than one virtualenv-type artifact at	source
`scan_all`	`scan_all(base, threshold_mb, stale_days, max_depth)`	2	Scan every project under `base` for removable artifacts, largest first.	source
`scan_project_artifacts`	`scan_project_artifacts(project_root, threshold_mb, stale_days)`	7	Find removable artifacts directly under a single project root.	source
`summarize`	`summarize(artifacts)`	9	Aggregate stats used for the CLI summary header.	source
`collect_quick_snapshot`	`collect_quick_snapshot()`	7	Collect a bounded, heuristic snapshot without using an LLM.	source
`main`	`main()`	1	Test the service data scanner.	source
`get_full_diagnostics`	`get_full_diagnostics(modules, progress_callback)`	12 ⚠️	Zbiera diagnostykę z wybranych modułów.	source
`format_size`	`format_size(size_bytes)`	3	Format bytes to human-readable string (B/KB/MB/GB/TB/PB).	source
`refresh_endpoint`	`refresh_endpoint(name, url)`	26 ⚠️	Observe one endpoint and retain the last good result on DNS failure.	source
`main`	`main()`	1	Test the cleanup planner	source
`execute_command`	`execute_command(cmd)`	10	Wykonuje komendę systemową z potwierdzeniem użytkownika.	source
`format_time`	`format_time(seconds)`	1	—	source
`run_llm_shell`	`run_llm_shell(diagnostics_data, token, model, timeout, ...)`	8	Uruchamia interaktywny shell LLM z przekazanymi danymi diagnostycznymi.	source
`default_pin_path`	`default_pin_path()`	2	Return the XDG-compliant per-user pin store path.	source
`normalize_project_path`	`normalize_project_path(value)`	3	Return a stable absolute path without requiring the path to exist.	source
`cancel_signal_timeout`	`cancel_signal_timeout()`	2	Cancels the timeout signal (POSIX only).	source
`elevate_cmd`	`elevate_cmd(cmd)`	3	Adds sudo (Linux/Mac) or wraps in PowerShell -Verb RunAs (Windows).	source
`get_os_info`	`get_os_info()`	5	Returns basic OS information.	source
`get_package_manager`	`get_package_manager()`	8	Detects the system package manager.	source
`install_package_cmd`	`install_package_cmd(package)`	2	Returns the install command for the detected package manager.	source
`is_dangerous`	`is_dangerous(cmd)`	3	Returns reason string if command is dangerous, None if safe.	source
`is_interactive_blocker`	`is_interactive_blocker(cmd)`	3	Returns reason string if command is likely to hang in non-interactive session.	source
`needs_elevation`	`needs_elevation(cmd)`	5	Returns True if command likely needs admin/sudo.	source
`run_command`	`run_command(cmd, timeout, shell)`	5	Runs a command cross-platform.	source
`setup_signal_timeout`	`setup_signal_timeout(seconds, handler)`	2	Sets up a timeout signal. Returns True if supported (POSIX only).	source
`main`	`main()`	1	Test the LLM analyzer	source
`get_cpu_info`	`get_cpu_info()`	2	Metryki CPU.	source
`get_disk_info`	`get_disk_info()`	3	Metryki dysków dla wszystkich partycji.	source
`get_fedora_specific`	`get_fedora_specific()`	1	Komendy specyficzne dla system: dnf, journalctl, systemctl.	source
`get_full_diagnostics`	`get_full_diagnostics()`	1	Zbiera kompletne dane diagnostyczne systemu system.	source
`get_memory_info`	`get_memory_info()`	1	Metryki RAM i SWAP.	source
`get_network_info`	`get_network_info()`	4	Statystyki sieciowe (bez wrażliwych danych - anonimizacja jest osobno).	source
`get_top_processes`	`get_top_processes(n)`	3	Lista TOP N procesów według zużycia CPU.	source
`run_cmd`	`run_cmd(cmd, timeout)`	6	Uruchamia komendę shell i zwraca output. Bezpieczny fallback przy błędzie.	source
`anonymize`	`anonymize(data_str, context)`	7	Anonimizuje wrażliwe dane.	source
`deanonymize`	`deanonymize(text, context, allowed_aliases)`	3	Resolve aliases locally while preserving the legacy primary tokens.	source
`display_anonymized_preview`	`display_anonymized_preview(data_str, report, max_lines)`	5	Wyświetla użytkownikowi zanonimizowane dane przed wysłaniem do LLM.	source
`colorize`	`colorize(line)`	1	Return line unchanged – rich handles markup in render_md().	source
`print_cmd_block`	`print_cmd_block(cmd, comment, dry_run)`	4	Print a framed command preview panel.	source
`print_problem_header`	`print_problem_header(problem_id, description, severity, status, ...)`	3	Print a colored problem header panel.	source
`print_stderr_box`	`print_stderr_box(stderr, max_lines)`	1	Print stderr in a rich Panel.	source
`print_stdout_box`	`print_stdout_box(stdout, max_lines)`	1	Print stdout in a rich Panel.	source
`render_md`	`render_md(text)`	9	Print LLM markdown reply to terminal via rich.	source
`render_tree_colored`	`render_tree_colored(nodes, execution_order)`	8	Render a ProblemGraph as a rich-markup string.	source
`timeout_handler`	`timeout_handler(signum, frame)`	1	Signal handler dla SIGALRM — rzuca SessionTimeout.	source
`format_results_for_llm`	`format_results_for_llm(results)`	3	Formatuje wyniki wyszukiwania do wklejenia w prompt LLM.	source
`search_all`	`search_all(query, serpapi_key, max_per_source)`	5	Przeszukuje wszystkie dostępne źródła wiedzy.	source
`search_arch_wiki`	`search_arch_wiki(query, max_results)`	9	Arch Wiki – doskonałe źródło dla problemów Linux (nie tylko Arch).	source
`search_ask_fedora`	`search_ask_fedora(query, max_results)`	4	Szuka w Linux forums przez Discourse API.	source
`search_ddg`	`search_ddg(query, max_results)`	8	DuckDuckGo Instant Answer API (bez klucza, ograniczone).	source
`search_fedora_bugzilla`	`search_fedora_bugzilla(query, max_results)`	4	Szuka w Linux Bugzilla przez REST API.	source
`search_github_issues`	`search_github_issues(query, max_results)`	4	GitHub Issues – linuxhardware, ALSA, PipeWire, PulseAudio repos.	source
`search_serpapi`	`search_serpapi(query, api_key, max_results)`	5	SerpAPI – Google/Bing search (wymaga klucza API).	source

docker

`docker.test-multi-system` source

Function	Signature	CC	Description	Source
`test_system`	`test_system()`	—	—	source

`docker.test-scenarios` source

Function	Signature	CC	Description	Source
`build_base`	`build_base()`	—	—	source
`main`	`main()`	—	—	source
`run_scenario`	`run_scenario()`	—	—	source

`docker.validate-scenario` source

Function	Signature	CC	Description	Source
`main`	`main()`	7	—	source
`validate`	`validate(data, scenario)`	11 ⚠️	Validate data against scenario expectations. Returns list of failures.	source

docs

`docs.examples.quickstart` source

Function	Signature	CC	Description	Source
`run_autonomous_session`	`run_autonomous_session()`	1	—	source

fixos

`fixos.agent` source

Class	Methods	Description	Source
`AgentReport`	1	—	source
`AutonomousSession`	1	Self-directed autonomous diagnostic and repair session.	source
`FixAction`	0	—	source
`HITLSession`	2	Interactive Human-in-the-Loop diagnostic and repair session.	source
`CmdResult`	1	Result of executed command.	source
`DiagnosticChoice`	0	A diagnosed problem that is selectable but has no executable plan yet.	source
`RemediationAction`	2	One policy-labelled strategy for resolving a diagnostic finding.	source

HITLSession methods:

remaining() — Get remaining session time in seconds.
run() — Run the HITL session.

Function	Signature	CC	Description	Source
`run_autonomous_session`	`run_autonomous_session(diagnostics, config, show_data, max_fixes)`	1	Uruchamia autonomiczny tryb agenta.	source
`run_autonomous_session`	`run_autonomous_session(diagnostics, config, show_data, max_fixes)`	1	Run autonomous session (backward compatible wrapper).	source
`get_remaining_time`	`get_remaining_time(session)`	2	Calculate remaining session time in seconds.	source
`run_hitl_session`	`run_hitl_session(diagnostics, config, show_data)`	1	Run interactive HITL session with full transparency.	source
`run_hitl_session`	`run_hitl_session(diagnostics, config, show_data)`	1	Run interactive HITL session (backward compatible wrapper).	source
`extract_diagnostic_choices`	`extract_diagnostic_choices(reply)`	12 ⚠️	Extract non-executable choices from numbered diagnosis headings.	source
`extract_fixes`	`extract_fixes(reply)`	4	Extract (command, comment) pairs from LLM reply.	source
`extract_remediation_actions`	`extract_remediation_actions(reply)`	4	Parse a closed remediation plan, falling back to legacy command syntax.	source
`extract_search_topic`	`extract_search_topic(llm_reply)`	3	Extract search keywords from LLM reply.	source
`select_recommended_actions`	`select_recommended_actions(actions)`	4	Return at most one recommended strategy for each finding.	source
`strip_remediation_plan`	`strip_remediation_plan(reply)`	1	Hide the machine plan block from the human-readable diagnosis.	source
`transform_remediation_commands`	`transform_remediation_commands(action, transform)`	4	Apply anonymization reversal to executable fields only.	source
`handle_cleanup_intent`	`handle_cleanup_intent(messages)`	1	Ask for a cleanup plan without authorizing or executing any command.	source
`handle_describe_problem`	`handle_describe_problem(messages, ask_fn)`	2	Handle [D] Describe own problem command.	source
`handle_direct_command`	`handle_direct_command(user_in, messages, executed, run_cmd_fn)`	1	Handle [!cmd] Direct command execution.	source
`handle_execute_all`	`handle_execute_all(fixes, messages, executed, run_cmd_fn)`	17 ⚠️	Handle [A] Execute all commands.	source
`handle_fix_by_number`	`handle_fix_by_number(user_in, fixes, messages, executed, ...)`	9	Handle [N] Execute specific fix by number.	source
`handle_free_text`	`handle_free_text(user_in, messages)`	1	Handle free text input → send to LLM.	source
`handle_quit`	`handle_quit()`	1	Handle [Q] Quit command. Returns False to exit loop.	source
`handle_search`	`handle_search(user_in, messages, serpapi_key)`	2	Handle [search ] Web search command.	source
`handle_skip_all`	`handle_skip_all(messages)`	1	Handle [S] Skip all command.	source
`is_cleanup_intent`	`is_cleanup_intent(user_in)`	2	Recognize a bounded single-word spelling variant of `cleanup`.	source
`parse_user_input`	`parse_user_input(user_in, fixes, messages, executed, ...)`	10	Parse user input and execute appropriate handler.	source
`run_single_command`	`run_single_command(cmd, comment)`	5	Run a command with full transparency and safety checks.	source
`ask_execute_prompt`	`ask_execute_prompt()`	1	Ask user if they want to execute a command.	source
`ask_low_confidence_search`	`ask_low_confidence_search()`	1	Ask user if they want to search when LLM is uncertain.	source
`ask_send_data`	`ask_send_data()`	1	Ask user if they want to send data to LLM.	source
`ask_user_problem`	`ask_user_problem()`	2	Interactively asks the user to describe their problem.	source
`clear_thinking`	`clear_thinking()`	1	Clear the 'Analyzing...' indicator.	source
`fmt_time`	`fmt_time(s)`	1	Format seconds as HH:MM:SS.	source
`get_user_input`	`get_user_input(remaining)`	2	Get user input with prompt.	source
`print_action_menu`	`print_action_menu(fixes, remaining, total_tokens, completed_count)`	19 ⚠️	Print the refreshed interactive menu of remaining choices.	source
`print_blocked_command`	`print_blocked_command(cmd, reason)`	1	Print blocked dangerous command warning.	source
`print_cmd_preview`	`print_cmd_preview(cmd, comment)`	1	Shows command in a clear block before execution.	source
`print_cmd_result`	`print_cmd_result(result)`	8	Shows command result with colorized markdown.	source
`print_executing_all`	`print_executing_all(count)`	1	Print executing all recommended command sets message.	source
`print_invalid_option`	`print_invalid_option(user_in, max_option)`	1	Print invalid option message.	source
`print_llm_error`	`print_llm_error(e)`	1	Print LLM error message.	source
`print_llm_reply`	`print_llm_reply(reply)`	1	Render LLM reply with markdown formatting.	source
`print_no_commands`	`print_no_commands()`	1	Print no commands available message.	source
`print_no_results`	`print_no_results()`	1	Print no search results message.	source
`print_searching`	`print_searching()`	1	Print searching message.	source
`print_select_one`	`print_select_one()`	1	Explain that diagnosis-only choices must be focused individually.	source
`print_session_ended`	`print_session_ended()`	1	Print session ended message.	source
`print_session_header`	`print_session_header(os_info, pkg_manager, model, timeout, ...)`	1	Print session header with system info.	source
`print_session_interrupted`	`print_session_interrupted()`	1	Print session interrupted message.	source
`print_session_summary`	`print_session_summary(messages_count, elapsed, total_tokens, executed)`	3	Print session summary.	source
`print_thinking`	`print_thinking()`	1	Print 'Analyzing...' indicator.	source
`print_timeout`	`print_timeout()`	1	Print session timeout message.	source
`suspend_timeout`	`suspend_timeout()`	4	Context manager to temporarily suspend session timeout during user input.	source

`fixos.agent.autonomous` source

Function	Signature	CC	Description	Source
`run_autonomous_session`	`run_autonomous_session(diagnostics, config, show_data, max_fixes)`	1	Uruchamia autonomiczny tryb agenta.	source

`fixos.agent.autonomous_session` source

Class	Methods	Description	Source
`AgentReport`	1	—	source
`AutonomousSession`	1	Self-directed autonomous diagnostic and repair session.	source
`FixAction`	0	—	source

Function	Signature	CC	Description	Source
`run_autonomous_session`	`run_autonomous_session(diagnostics, config, show_data, max_fixes)`	1	Run autonomous session (backward compatible wrapper).	source

`fixos.agent.hitl` source

Function	Signature	CC	Description	Source
`run_hitl_session`	`run_hitl_session(diagnostics, config, show_data)`	1	Run interactive HITL session with full transparency.	source

`fixos.agent.hitl_session` source

Class	Methods	Description	Source
`HITLSession`	2	Interactive Human-in-the-Loop diagnostic and repair session.	source

HITLSession methods:

remaining() — Get remaining session time in seconds.
run() — Run the HITL session.

Function	Signature	CC	Description	Source
`run_hitl_session`	`run_hitl_session(diagnostics, config, show_data)`	1	Run interactive HITL session (backward compatible wrapper).	source

`fixos.agent.session_core` source

Class	Methods	Description	Source
`CmdResult`	1	Result of executed command.	source
`DiagnosticChoice`	0	A diagnosed problem that is selectable but has no executable plan yet.	source
`RemediationAction`	2	One policy-labelled strategy for resolving a diagnostic finding.	source

Function	Signature	CC	Description	Source
`extract_diagnostic_choices`	`extract_diagnostic_choices(reply)`	12 ⚠️	Extract non-executable choices from numbered diagnosis headings.	source
`extract_fixes`	`extract_fixes(reply)`	4	Extract (command, comment) pairs from LLM reply.	source
`extract_remediation_actions`	`extract_remediation_actions(reply)`	4	Parse a closed remediation plan, falling back to legacy command syntax.	source
`extract_search_topic`	`extract_search_topic(llm_reply)`	3	Extract search keywords from LLM reply.	source
`select_recommended_actions`	`select_recommended_actions(actions)`	4	Return at most one recommended strategy for each finding.	source
`strip_remediation_plan`	`strip_remediation_plan(reply)`	1	Hide the machine plan block from the human-readable diagnosis.	source
`transform_remediation_commands`	`transform_remediation_commands(action, transform)`	4	Apply anonymization reversal to executable fields only.	source

`fixos.agent.session_handlers` source

Function	Signature	CC	Description	Source
`handle_cleanup_intent`	`handle_cleanup_intent(messages)`	1	Ask for a cleanup plan without authorizing or executing any command.	source
`handle_describe_problem`	`handle_describe_problem(messages, ask_fn)`	2	Handle [D] Describe own problem command.	source
`handle_direct_command`	`handle_direct_command(user_in, messages, executed, run_cmd_fn)`	1	Handle [!cmd] Direct command execution.	source
`handle_execute_all`	`handle_execute_all(fixes, messages, executed, run_cmd_fn)`	17 ⚠️	Handle [A] Execute all commands.	source
`handle_fix_by_number`	`handle_fix_by_number(user_in, fixes, messages, executed, ...)`	9	Handle [N] Execute specific fix by number.	source
`handle_free_text`	`handle_free_text(user_in, messages)`	1	Handle free text input → send to LLM.	source
`handle_quit`	`handle_quit()`	1	Handle [Q] Quit command. Returns False to exit loop.	source
`handle_search`	`handle_search(user_in, messages, serpapi_key)`	2	Handle [search ] Web search command.	source
`handle_skip_all`	`handle_skip_all(messages)`	1	Handle [S] Skip all command.	source
`is_cleanup_intent`	`is_cleanup_intent(user_in)`	2	Recognize a bounded single-word spelling variant of `cleanup`.	source
`parse_user_input`	`parse_user_input(user_in, fixes, messages, executed, ...)`	10	Parse user input and execute appropriate handler.	source
`run_single_command`	`run_single_command(cmd, comment)`	5	Run a command with full transparency and safety checks.	source

`fixos.agent.session_io` source

Function	Signature	CC	Description	Source
`ask_execute_prompt`	`ask_execute_prompt()`	1	Ask user if they want to execute a command.	source
`ask_low_confidence_search`	`ask_low_confidence_search()`	1	Ask user if they want to search when LLM is uncertain.	source
`ask_send_data`	`ask_send_data()`	1	Ask user if they want to send data to LLM.	source
`ask_user_problem`	`ask_user_problem()`	2	Interactively asks the user to describe their problem.	source
`clear_thinking`	`clear_thinking()`	1	Clear the 'Analyzing...' indicator.	source
`fmt_time`	`fmt_time(s)`	1	Format seconds as HH:MM:SS.	source
`get_user_input`	`get_user_input(remaining)`	2	Get user input with prompt.	source
`print_action_menu`	`print_action_menu(fixes, remaining, total_tokens, completed_count)`	19 ⚠️	Print the refreshed interactive menu of remaining choices.	source
`print_blocked_command`	`print_blocked_command(cmd, reason)`	1	Print blocked dangerous command warning.	source
`print_cmd_preview`	`print_cmd_preview(cmd, comment)`	1	Shows command in a clear block before execution.	source
`print_cmd_result`	`print_cmd_result(result)`	8	Shows command result with colorized markdown.	source
`print_executing_all`	`print_executing_all(count)`	1	Print executing all recommended command sets message.	source
`print_invalid_option`	`print_invalid_option(user_in, max_option)`	1	Print invalid option message.	source
`print_llm_error`	`print_llm_error(e)`	1	Print LLM error message.	source
`print_llm_reply`	`print_llm_reply(reply)`	1	Render LLM reply with markdown formatting.	source
`print_no_commands`	`print_no_commands()`	1	Print no commands available message.	source
`print_no_results`	`print_no_results()`	1	Print no search results message.	source
`print_searching`	`print_searching()`	1	Print searching message.	source
`print_select_one`	`print_select_one()`	1	Explain that diagnosis-only choices must be focused individually.	source
`print_session_ended`	`print_session_ended()`	1	Print session ended message.	source
`print_session_header`	`print_session_header(os_info, pkg_manager, model, timeout, ...)`	1	Print session header with system info.	source
`print_session_interrupted`	`print_session_interrupted()`	1	Print session interrupted message.	source
`print_session_summary`	`print_session_summary(messages_count, elapsed, total_tokens, executed)`	3	Print session summary.	source
`print_thinking`	`print_thinking()`	1	Print 'Analyzing...' indicator.	source
`print_timeout`	`print_timeout()`	1	Print session timeout message.	source
`suspend_timeout`	`suspend_timeout()`	4	Context manager to temporarily suspend session timeout during user input.	source

`fixos.anonymizer` source

Function	Signature	CC	Description	Source
`anonymize`	`anonymize(data_str)`	1	Keep the original string-only return shape used by `llm_shell`.	source
`get_sensitive_values`	`get_sensitive_values()`	1	Return legacy key names without maintaining a second privacy policy.	source

`fixos.cli` source

Class	Methods	Description	Source
`OutputFormat`	0	Supported output formats.	source
`OutputFormatter`	9	Centralized output formatter for fixOS CLI commands.	source
`NaturalLanguageGroup`	1	Click group that intelligently handles typos and routes natural language commands to 'ask'.	source

OutputFormatter methods:

from_flags(cls, yaml_output, json_output) — Create formatter from CLI flag values. YAML takes precedence over JSON.
status(msg, fg, bold) — Print a status/progress message. Goes to stderr in machine mode.
progress(name, desc) — Print a progress line for diagnostic module collection.
banner(text) — Print banner. Suppressed in machine mode.
emit(data, stream) — Emit structured data to stdout in the configured format.
format_data(data) — Format data dict/list as string in the configured format.
format_diagnostics(data) — Format full diagnostic result with metadata envelope.
format_scan_result(data) — Format scan results with optional disk analysis.

Function	Signature	CC	Description	Source
`ask`	`ask(prompt, dry_run)`	1	Wykonaj polecenie w języku naturalnym.	source
`cleanup_services`	`cleanup_services(threshold, services, json_output, cleanup, ...)`	56 ⚠️	Skanuje i czyści dane usług przekraczające próg.	source
`config`	`config()`	1	Zarządzanie konfiguracją fixOS.	source
`config_init`	`config_init(force)`	3	Zainicjalizuj plik konfiguracyjny .env.	source
`config_model`	`config_model(provider)`	8	Interaktywnie wybierz model LLM z listy.	source
`config_provider`	`config_provider()`	6	Interaktywnie wybierz providera LLM z listy.	source
`config_set`	`config_set(key, value)`	2	Ustaw wartość konfiguracyjną w .env.	source
`config_show`	`config_show()`	4	Pokaż aktualną konfigurację.	source
`features`	`features()`	1	Zarządzanie pakietami komfortu systemu.	source
`features_audit`	`features_audit(profile, json_output)`	4	Sprawdź brakujące pakiety dla profilu.	source
`features_install`	`features_install(profile, dry_run, yes, category)`	7	Zainstaluj brakujące pakiety dla profilu.	source
`features_profiles`	`features_profiles()`	3	Lista dostępnych profili.	source
`features_system`	`features_system()`	1	Pokaż wykryty system.	source
`execute_cleanup_actions`	`execute_cleanup_actions(actions, cfg, llm_fallback)`	6	Execute cleanup actions with safety checks	source
`fix`	`fix(provider, token, model, no_banner, ...)`	13 ⚠️	Przeprowadza pełną diagnostykę i uruchamia sesję naprawczą z LLM.	source
`handle_disk_cleanup_mode`	`handle_disk_cleanup_mode(disk_analysis, cfg, dry_run, interactive, ...)`	13 ⚠️	Handle disk cleanup mode with interactive planning	source
`try_llm_fallback_for_failures`	`try_llm_fallback_for_failures(failed_actions, cfg)`	3	Try to fix failed actions using LLM	source
`history`	`history(limit, json_output)`	5	Historia napraw fixOS.	source
`ai_control`	`ai_control(config_dir, disable_plugins, stop_qoder, apply, ...)`	23 ⚠️	Diagnozuj i ogranicz dodatki AI bez zamykania okien IDE.	source
`doctor`	`doctor(pid, minutes, no_thread_dump, json_output, ...)`	25 ⚠️	Zbierz metryki JVM, stan EDT i sygnały z idea.log.	source
`jetbrains`	`jetbrains()`	1	Diagnozuj współdzieloną JVM JetBrains bez zamykania okien.	source
`cli`	`cli(ctx, dry_run, interactive_mode, version)`	7	fixos – AI-powered diagnostyka i naprawa Linux, Windows, macOS.	source
`main`	`main()`	1	Entry point for fixOS CLI.	source
`orchestrate`	`orchestrate(provider, token, model, no_banner, ...)`	13 ⚠️	Zaawansowana orkiestracja napraw z grafem problemów.	source
`profile`	`profile()`	1	Zarządzanie profilami diagnostycznymi.	source
`profile_list`	`profile_list()`	4	Pokaż dostępne profile diagnostyczne.	source
`profile_show`	`profile_show(name)`	4	Pokaż szczegóły profilu diagnostycznego.	source
`projects_cmd`	`projects_cmd(path, threshold, stale_days, only_stale, ...)`	24 ⚠️	Skanuje projekty deweloperskie (np. ~/github//) w poszukiwaniu	source
`llm_providers`	`llm_providers(free)`	6	Lista dostępnych providerów LLM.	source
`providers`	`providers()`	4	Lista providerów LLM z oznaczeniem FREE/PAID.	source
`test_llm`	`test_llm(provider, token, model, no_banner)`	9	Test połączenia z LLM.	source
`quick`	`quick(hours, json_output, deep, no_save)`	11 ⚠️	Natychmiastowa analiza CPU, RAM, dysku, cache i ostatnich przyrostów.	source
`render_quick_snapshot`	`render_quick_snapshot(snapshot)`	25 ⚠️	Render the quick snapshot in a stable, readable form.	source
`quickfix`	`quickfix(dry_run, modules)`	12 ⚠️	Natychmiastowe naprawy bez API — baza znanych bugów.	source
`report`	`report(output_format, output, modules, profile)`	5	Eksport wyników diagnostyki do raportu HTML/Markdown/JSON.	source
`rollback`	`rollback()`	1	Zarządzanie cofaniem operacji fixOS.	source
`rollback_list`	`rollback_list(limit)`	3	Pokaż historię sesji naprawczych.	source
`rollback_show`	`rollback_show(session_id)`	5	Pokaż szczegóły sesji rollback.	source
`rollback_undo`	`rollback_undo(session_id, last, dry_run)`	7	Cofnij operacje z podanej sesji.	source
`scan`	`scan(modules, output, show_raw, no_banner, ...)`	11 ⚠️	Przeprowadza diagnostykę systemu.	source
`add_common_options`	`add_common_options(fn)`	2	Decorator adding common LLM options to a Click command.	source
`add_shared_options`	`add_shared_options(func)`	1	Shared options for both scan and fix commands.	source
`get_banner`	`get_banner()`	1	Return the CLI banner with the installed package version.	source
`get_command_completer`	`get_command_completer()`	1	Build a nested completer for all fixOS commands and common options.	source
`print_interactive_menu`	`print_interactive_menu()`	2	Display the interactive quick menu.	source
`run_interactive_shell`	`run_interactive_shell(ctx)`	16 ⚠️	Run the main interactive prompt loop.	source
`shell_cmd`	`shell_cmd(ctx)`	1	Uruchom interaktywny shell fixOS z menu i autouzupełnianiem TAB.	source
`token`	`token()`	1	Zarządzanie tokenem API.	source
`token_clear`	`token_clear(env_file)`	3	Usuń token z pliku .env.	source
`token_set`	`token_set(key, provider, env_file)`	7	Zapisz token API do pliku .env.	source
`token_show`	`token_show()`	2	Pokaż obecny token (masked).	source
`watch`	`watch(interval, modules, alert_on, max_iterations)`	2	Monitorowanie systemu w tle z powiadomieniami.	source

`fixos.cli.ask_cmd` source

Function	Signature	CC	Description	Source
`ask`	`ask(prompt, dry_run)`	1	Wykonaj polecenie w języku naturalnym.	source

`fixos.cli.cleanup_cmd` source

Function	Signature	CC	Description	Source
`cleanup_services`	`cleanup_services(threshold, services, json_output, cleanup, ...)`	56 ⚠️	Skanuje i czyści dane usług przekraczające próg.	source

`fixos.cli.config_cmd` source

Function	Signature	CC	Description	Source
`config`	`config()`	1	Zarządzanie konfiguracją fixOS.	source
`config_init`	`config_init(force)`	3	Zainicjalizuj plik konfiguracyjny .env.	source
`config_model`	`config_model(provider)`	8	Interaktywnie wybierz model LLM z listy.	source
`config_provider`	`config_provider()`	6	Interaktywnie wybierz providera LLM z listy.	source
`config_set`	`config_set(key, value)`	2	Ustaw wartość konfiguracyjną w .env.	source
`config_show`	`config_show()`	4	Pokaż aktualną konfigurację.	source

`fixos.cli.features_cmd` source

Function	Signature	CC	Description	Source
`features`	`features()`	1	Zarządzanie pakietami komfortu systemu.	source
`features_audit`	`features_audit(profile, json_output)`	4	Sprawdź brakujące pakiety dla profilu.	source
`features_install`	`features_install(profile, dry_run, yes, category)`	7	Zainstaluj brakujące pakiety dla profilu.	source
`features_profiles`	`features_profiles()`	3	Lista dostępnych profili.	source
`features_system`	`features_system()`	1	Pokaż wykryty system.	source

`fixos.cli.fix_cmd` source

Function	Signature	CC	Description	Source
`execute_cleanup_actions`	`execute_cleanup_actions(actions, cfg, llm_fallback)`	6	Execute cleanup actions with safety checks	source
`fix`	`fix(provider, token, model, no_banner, ...)`	13 ⚠️	Przeprowadza pełną diagnostykę i uruchamia sesję naprawczą z LLM.	source
`handle_disk_cleanup_mode`	`handle_disk_cleanup_mode(disk_analysis, cfg, dry_run, interactive, ...)`	13 ⚠️	Handle disk cleanup mode with interactive planning	source
`try_llm_fallback_for_failures`	`try_llm_fallback_for_failures(failed_actions, cfg)`	3	Try to fix failed actions using LLM	source

`fixos.cli.history_cmd` source

Function	Signature	CC	Description	Source
`history`	`history(limit, json_output)`	5	Historia napraw fixOS.	source

`fixos.cli.jetbrains_cmd` source

Function	Signature	CC	Description	Source
`ai_control`	`ai_control(config_dir, disable_plugins, stop_qoder, apply, ...)`	23 ⚠️	Diagnozuj i ogranicz dodatki AI bez zamykania okien IDE.	source
`doctor`	`doctor(pid, minutes, no_thread_dump, json_output, ...)`	25 ⚠️	Zbierz metryki JVM, stan EDT i sygnały z idea.log.	source
`jetbrains`	`jetbrains()`	1	Diagnozuj współdzieloną JVM JetBrains bez zamykania okien.	source

`fixos.cli.main` source

Function	Signature	CC	Description	Source
`cli`	`cli(ctx, dry_run, interactive_mode, version)`	7	fixos – AI-powered diagnostyka i naprawa Linux, Windows, macOS.	source
`main`	`main()`	1	Entry point for fixOS CLI.	source

`fixos.cli.orchestrate_cmd` source

Function	Signature	CC	Description	Source
`orchestrate`	`orchestrate(provider, token, model, no_banner, ...)`	13 ⚠️	Zaawansowana orkiestracja napraw z grafem problemów.	source

`fixos.cli.output_formatter` source

Class	Methods	Description	Source
`OutputFormat`	0	Supported output formats.	source
`OutputFormatter`	9	Centralized output formatter for fixOS CLI commands.	source

OutputFormatter methods:

from_flags(cls, yaml_output, json_output) — Create formatter from CLI flag values. YAML takes precedence over JSON.
status(msg, fg, bold) — Print a status/progress message. Goes to stderr in machine mode.
progress(name, desc) — Print a progress line for diagnostic module collection.
banner(text) — Print banner. Suppressed in machine mode.
emit(data, stream) — Emit structured data to stdout in the configured format.
format_data(data) — Format data dict/list as string in the configured format.
format_diagnostics(data) — Format full diagnostic result with metadata envelope.
format_scan_result(data) — Format scan results with optional disk analysis.

`fixos.cli.profile_cmd` source

Function	Signature	CC	Description	Source
`profile`	`profile()`	1	Zarządzanie profilami diagnostycznymi.	source
`profile_list`	`profile_list()`	4	Pokaż dostępne profile diagnostyczne.	source
`profile_show`	`profile_show(name)`	4	Pokaż szczegóły profilu diagnostycznego.	source

`fixos.cli.projects_cmd` source

Function	Signature	CC	Description	Source
`projects_cmd`	`projects_cmd(path, threshold, stale_days, only_stale, ...)`	24 ⚠️	Skanuje projekty deweloperskie (np. ~/github//) w poszukiwaniu	source

`fixos.cli.provider_cmd` source

Function	Signature	CC	Description	Source
`llm_providers`	`llm_providers(free)`	6	Lista dostępnych providerów LLM.	source
`providers`	`providers()`	4	Lista providerów LLM z oznaczeniem FREE/PAID.	source
`test_llm`	`test_llm(provider, token, model, no_banner)`	9	Test połączenia z LLM.	source

`fixos.cli.quick_cmd` source

Function	Signature	CC	Description	Source
`quick`	`quick(hours, json_output, deep, no_save)`	11 ⚠️	Natychmiastowa analiza CPU, RAM, dysku, cache i ostatnich przyrostów.	source
`render_quick_snapshot`	`render_quick_snapshot(snapshot)`	25 ⚠️	Render the quick snapshot in a stable, readable form.	source

`fixos.cli.quickfix_cmd` source

Function	Signature	CC	Description	Source
`quickfix`	`quickfix(dry_run, modules)`	12 ⚠️	Natychmiastowe naprawy bez API — baza znanych bugów.	source

`fixos.cli.report_cmd` source

Function	Signature	CC	Description	Source
`report`	`report(output_format, output, modules, profile)`	5	Eksport wyników diagnostyki do raportu HTML/Markdown/JSON.	source

`fixos.cli.rollback_cmd` source

Function	Signature	CC	Description	Source
`rollback`	`rollback()`	1	Zarządzanie cofaniem operacji fixOS.	source
`rollback_list`	`rollback_list(limit)`	3	Pokaż historię sesji naprawczych.	source
`rollback_show`	`rollback_show(session_id)`	5	Pokaż szczegóły sesji rollback.	source
`rollback_undo`	`rollback_undo(session_id, last, dry_run)`	7	Cofnij operacje z podanej sesji.	source

`fixos.cli.scan_cmd` source

Function	Signature	CC	Description	Source
`scan`	`scan(modules, output, show_raw, no_banner, ...)`	11 ⚠️	Przeprowadza diagnostykę systemu.	source

`fixos.cli.shared` source

Class	Methods	Description	Source
`NaturalLanguageGroup`	1	Click group that intelligently handles typos and routes natural language commands to 'ask'.	source

Function	Signature	CC	Description	Source
`add_common_options`	`add_common_options(fn)`	2	Decorator adding common LLM options to a Click command.	source
`add_shared_options`	`add_shared_options(func)`	1	Shared options for both scan and fix commands.	source
`get_banner`	`get_banner()`	1	Return the CLI banner with the installed package version.	source

`fixos.cli.shell_cmd` source

Function	Signature	CC	Description	Source
`get_command_completer`	`get_command_completer()`	1	Build a nested completer for all fixOS commands and common options.	source
`print_interactive_menu`	`print_interactive_menu()`	2	Display the interactive quick menu.	source
`run_interactive_shell`	`run_interactive_shell(ctx)`	16 ⚠️	Run the main interactive prompt loop.	source
`shell_cmd`	`shell_cmd(ctx)`	1	Uruchom interaktywny shell fixOS z menu i autouzupełnianiem TAB.	source

`fixos.cli.token_cmd` source

Function	Signature	CC	Description	Source
`token`	`token()`	1	Zarządzanie tokenem API.	source
`token_clear`	`token_clear(env_file)`	3	Usuń token z pliku .env.	source
`token_set`	`token_set(key, provider, env_file)`	7	Zapisz token API do pliku .env.	source
`token_show`	`token_show()`	2	Pokaż obecny token (masked).	source

`fixos.cli.watch_cmd` source

Function	Signature	CC	Description	Source
`watch`	`watch(interval, modules, alert_on, max_iterations)`	2	Monitorowanie systemu w tle z powiadomieniami.	source

`fixos.config` source

Class	Methods	Description	Source
`FixOsConfig`	3	—	source

FixOsConfig methods:

load(cls) — Tworzy konfigurację z połączonych źródeł.
validate() — Zwraca listę błędów walidacji (pusta = OK).
summary() — Krótkie podsumowanie konfiguracji (bez klucza API).

Function	Signature	CC	Description	Source
`detect_provider_from_key`	`detect_provider_from_key(key)`	3	Wykrywa provider na podstawie prefiksu klucza API.	source
`get_providers_list`	`get_providers_list()`	3	Zwraca listę providerów jako listę słowników.	source
`interactive_provider_setup`	`interactive_provider_setup()`	1	Interaktywny wybór providera gdy brak konfiguracji.	source

`fixos.config_interactive` source

Function	Signature	CC	Description	Source
`interactive_provider_setup`	`interactive_provider_setup()`	5	Interaktywny wybór providera gdy brak konfiguracji.	source

`fixos.diagnostics` source

Class	Methods	Description	Source
`DevProjectAnalyzer`	5	Analyze developer projects for dependency folders that can be cleaned.	source
`ProjectDependency`	1	Represents a dependency folder that can be cleaned	source
`DiskAnalyzer`	6	Analyzes disk usage and provides cleanup suggestions	source
`DockerNetworkCleaner`	3	Usuwa wyłącznie sieci bez endpointów i testuje pulę adresową.	source
`DockerStartupOptimizer`	2	Find and explicitly disable stale repository-backed Docker autostart.	source
`FlatpakAnalyzer`	1	Advanced analyzer for Flatpak cleanup decisions	source
`FlatpakItemInfo`	1	Detailed info about a Flatpak item (app, runtime, or data)	source
`FlatpakItemType`	0	—	source
`JetBrainsAiControl`	5	Inspect or explicitly disable AI plugins and stop exact Qoder helpers.	source
`JetBrainsAiSafetyError`	0	Raised when an AI-control target cannot be proven exact and safe.	source
`EdtThreadState`	1	—	source
`JetBrainsDiagnosis`	0	—	source
`JetBrainsLogSignals`	1	—	source
`JetBrainsMetrics`	0	—	source
`JetBrainsRecovery`	3	Correlate JetBrains evidence and optionally run a bounded JVM GC.	source
`JetBrainsRecoveryResult`	0	—	source
`JetBrainsRecoverySafetyError`	0	Raised when a recovery request cannot be proven safe and applicable.	source
`JvmHeapInfo`	1	—	source
`OrphanedWorkloadCleaner`	2	Find and explicitly clean missing-project Docker and process workloads.	source
`OrphanedWorkloadSafetyError`	0	Raised when an exact cleanup target no longer satisfies safety checks.	source
`FileLockWait`	0	One kernel-reported file-lock dependency.	source
`ProcessChainFinding`	2	A fresh process subtree and the evidence associated with it.	source
`ProcessChainInspector`	4	List, analyse and explicitly terminate recent process subtrees.	source
`ProcessChainSafetyError`	0	Raised when a requested process-tree action fails a safety check.	source
`ProcessRecord`	3	Stable process metadata captured at one point in time.	source
`TerminationResult`	1	Result of a dry run or an attempted tree termination.	source
`ProjectArtifact`	0	A single removable artifact directory found inside a project.	source
`CacheRule`	0	—	source
`ServiceCleaner`	19	Plans and executes cleanup of service data.	source
`ServiceDetailsProvider`	1	Provides detailed information about service data.	source
`RiskLevel`	0	How risky it is to delete a scanned service's data.	source
`ServiceDataInfo`	0	Information about service data.	source
`ServiceDataScanner`	5	Scans for large service data directories and allows cleanup.	source
`ServiceType`	0	Service types that can be scanned and cleaned.	source
`StorageAnalyzer`	2	Comprehensive storage analyzer for Linux systems.	source
`StorageItem`	1	Represents a storage item that can be cleaned	source

DevProjectAnalyzer methods:

analyze(max_depth) — Scan home directory for dependency folders.
get_old_dependencies(days) — Get dependencies not modified in X days
get_large_dependencies(min_size_mb) — Get dependencies larger than X MB
get_summary() — Get human-readable summary
get_cleanup_commands() — Get cleanup commands for each dependency

DiskAnalyzer methods:

analyze_disk_usage(path) — Comprehensive disk usage analysis
get_large_files(path, min_size_mb, max_files) — Find large files
get_cache_dirs(path, max_dirs) — Find cache directories
get_log_dirs(path, max_dirs) — Find log directories
get_temp_dirs(path, max_dirs) — Find temporary directories
suggest_cleanup_actions(path) — Generate cleanup suggestions using heuristics

DockerNetworkCleaner methods:

list_unused(min_age_days) — Zwróć niestandardowe sieci bez endpointów.
probe_address_pool() — Utwórz i usuń tymczasową sieć, potwierdzając dostępność puli.
cleanup() — Usuń dokładnie wykryte sieci i opcjonalnie sprawdź pulę adresową.

DockerStartupOptimizer methods:

scan(min_inactive_days) — Return evidence and stale candidates without changing Docker state.
optimize(container_ids) — Disable exact stale candidates and optionally stop them.

JetBrainsAiControl methods:

find_qoder_helpers(records)
find_config_dirs(records, explicit)
status()
disable_plugins(config_dir)
stop_qoder_helpers(identities)

JetBrainsRecovery methods:

find_main_processes(records)
diagnose(pid)
recover(diagnosis) — Optionally run GC.run and verify evidence without closing the IDE.

OrphanedWorkloadCleaner methods:

scan() — Return exact orphan evidence without changing Docker or processes.
cleanup() — Revalidate and apply only exact selected orphan candidates.

ProcessChainInspector methods:

snapshot()
list_recent() — Return newest processes first, without classifying them as blockers.
find_suspicious_chains() — Reconstruct fresh trees and attach explainable blocking evidence.
terminate_chain(finding) — Terminate one selected tree after identity and ancestry checks.

ProcessRecord methods:

age_seconds(now)
to_dict()

ServiceCleaner methods:

docker_old_unused_until_hours(days) — Convert a positive day count to Docker until=<Nh> hours.
get_docker_old_unused_command(days) — Bounded prune: unused images (and old build cache) older than N days.
list_ollama_models() — Return installed Ollama models with name/size/modified_at (UTC).
list_running_ollama_models() — Names of models currently loaded in memory (must not be deleted).
select_old_ollama_models(models, days) — Filter models whose modified_at is older than N days; skip running ones.
cleanup_ollama_old_unused(days, dry_run) — Remove Ollama models not modified for more than N days (skip running).
get_docker_unused_command() — Prune all unused images and rebuildable build cache (no age filter).
cleanup_docker_unused(dry_run) — Remove unused images/cache and optionally orphaned networks.
cleanup_docker_networks(days, dry_run) — Remove unused custom networks and verify Docker address-pool allocation.
cleanup_docker_old_unused(days, dry_run) — Remove old images/cache and optionally orphaned networks.
build_safe_age_actions(selected_services) — Bounded age-based cleanups treated as safe (option [1] in interactive cleanup).
get_cleanup_plan(selected_services) — Generate cleanup plan for services, split into 3 risk tiers.
cleanup_service(service_type, dry_run, planned_service) — Execute cleanup for a specific service or exact planned entry.
get_risk_level(service_type, path) — Classify cleanup risk for a service path.
is_safe_cleanup(service_type, path) — Backward-compatible bool view of get_risk_level() == SAFE.
get_cleanup_hints(service_type, size_gb) — Get helpful hints for cleaning services that require manual review.
get_service_description(service_type) — Get description for service type.
get_cleanup_command(service_type, path) — Get a bounded cleanup command for a scanned service path.
get_preview_command(service_type, path) — Get preview command for service.

ServiceDataScanner methods:

scan_all_services() — Scan all known services for data above threshold.
scan_service(service_type) — Scan specific service type for data.
measure_service_size_mb(service_type, path) — Measure a service with the same source before and after cleanup.
get_cleanup_plan(selected_services) — Generate cleanup plan for services.
cleanup_service(service_type, dry_run, planned_service) — Execute cleanup for a specific service.

StorageAnalyzer methods:

analyze_full() — Run full system storage analysis
get_summary() — Get human-readable summary

Function	Signature	CC	Description	Source
`discover_additional_caches`	`discover_additional_caches(get_size_mb, threshold_mb, covered_paths)`	5	Discover large caches not already covered by known service scanners.	source
`is_generic_cache_safe`	`is_generic_cache_safe(path)`	2	Heuristic safety check for unknown cache directories.	source
`normalize_path`	`normalize_path(path)`	1	—	source
`path_is_covered`	`path_is_covered(path, covered_paths)`	5	Return True when path is already represented by a known service scan.	source
`diagnose_audio`	`diagnose_audio()`	1	Diagnostyka dźwięku (ALSA/PipeWire/PulseAudio/SOF).	source
`diagnose_files`	`diagnose_files()`	4	Diagnostyka plików użytkownika.	source
`diagnose_hardware`	`diagnose_hardware()`	1	Diagnostyka sprzętu laptopa/desktopa (ACPI, kamera, touchpad, DMI).	source
`diagnose_packages`	`diagnose_packages()`	4	Diagnostyka zainstalowanych pakietów i środowiska.	source
`diagnose_resources`	`diagnose_resources()`	13 ⚠️	Diagnostyka zasobów systemowych.	source
`diagnose_security`	`diagnose_security()`	4	Diagnostyka bezpieczeństwa systemu i sieci.	source
`diagnose_storage`	`diagnose_storage()`	4	Diagnostyka optymalizacji dysków i partycji.	source
`diagnose_system`	`diagnose_system()`	11 ⚠️	System metrics – cross-platform: CPU, RAM, disks, processes.	source
`diagnose_thumbnails`	`diagnose_thumbnails()`	1	Diagnostyka podglądów plików (thumbnails) w system.	source
`main`	`main()`	1	Test the disk analyzer	source
`analyze_flatpak_for_cleanup`	`analyze_flatpak_for_cleanup()`	1	Convenience function to run full Flatpak analysis	source
`analyze_idea_log`	`analyze_idea_log(text)`	15 ⚠️	Extract bounded, explainable stall signals from JetBrains log text.	source
`collect_jetbrains_metrics`	`collect_jetbrains_metrics(pid)`	2	—	source
`is_main_jetbrains_process`	`is_main_jetbrains_process(process)`	1	Return true only for a main IDE process, never a helper/server.	source
`jetbrains_product_marker`	`jetbrains_product_marker(process)`	9	Identify a product only from its launcher, never arbitrary arguments.	source
`parse_edt_thread`	`parse_edt_thread(text)`	7	Extract the AWT event-dispatch thread from a `Thread.print` result.	source
`parse_heap_info`	`parse_heap_info(text)`	2	—	source
`read_log_since`	`read_log_since(path, offset)`	3	—	source
`read_log_tail`	`read_log_tail(path)`	2	—	source
`collect_processes`	`collect_processes()`	13 ⚠️	Collect a best-effort process snapshot using the existing psutil dependency.	source
`parse_proc_locks`	`parse_proc_locks(text)`	8	Parse blocked lock requests from Linux `/proc/locks` content.	source
`read_linux_lock_waits`	`read_linux_lock_waits(path)`	2	Read Linux lock dependencies; return no evidence on other/denied systems.	source
`discover_project_roots`	`discover_project_roots(base, max_depth)`	9	Find developer project roots under `base` (dirs carrying a known	source
`find_duplicate_venvs`	`find_duplicate_venvs(artifacts)`	5	Project paths that carry more than one virtualenv-type artifact at	source
`scan_all`	`scan_all(base, threshold_mb, stale_days, max_depth)`	2	Scan every project under `base` for removable artifacts, largest first.	source
`scan_project_artifacts`	`scan_project_artifacts(project_root, threshold_mb, stale_days)`	7	Find removable artifacts directly under a single project root.	source
`summarize`	`summarize(artifacts)`	9	Aggregate stats used for the CLI summary header.	source
`collect_quick_snapshot`	`collect_quick_snapshot()`	7	Collect a bounded, heuristic snapshot without using an LLM.	source
`main`	`main()`	1	Test the service data scanner.	source
`get_full_diagnostics`	`get_full_diagnostics(modules, progress_callback)`	12 ⚠️	Zbiera diagnostykę z wybranych modułów.	source
`format_size`	`format_size(size_bytes)`	3	Format bytes to human-readable string (B/KB/MB/GB/TB/PB).	source

`fixos.diagnostics.cache_discovery` source

Function	Signature	CC	Description	Source
`discover_additional_caches`	`discover_additional_caches(get_size_mb, threshold_mb, covered_paths)`	5	Discover large caches not already covered by known service scanners.	source
`is_generic_cache_safe`	`is_generic_cache_safe(path)`	2	Heuristic safety check for unknown cache directories.	source
`normalize_path`	`normalize_path(path)`	1	—	source
`path_is_covered`	`path_is_covered(path, covered_paths)`	5	Return True when path is already represented by a known service scan.	source

`fixos.diagnostics.checks.audio` source

Function	Signature	CC	Description	Source
`diagnose_audio`	`diagnose_audio()`	1	Diagnostyka dźwięku (ALSA/PipeWire/PulseAudio/SOF).	source

`fixos.diagnostics.checks.file_analysis` source

Function	Signature	CC	Description	Source
`diagnose_files`	`diagnose_files()`	4	Diagnostyka plików użytkownika.	source

`fixos.diagnostics.checks.hardware` source

Function	Signature	CC	Description	Source
`diagnose_hardware`	`diagnose_hardware()`	1	Diagnostyka sprzętu laptopa/desktopa (ACPI, kamera, touchpad, DMI).	source

`fixos.diagnostics.checks.packages` source

Function	Signature	CC	Description	Source
`diagnose_packages`	`diagnose_packages()`	4	Diagnostyka zainstalowanych pakietów i środowiska.	source

`fixos.diagnostics.checks.resources` source

Function	Signature	CC	Description	Source
`diagnose_resources`	`diagnose_resources()`	13 ⚠️	Diagnostyka zasobów systemowych.	source

`fixos.diagnostics.checks.security` source

Function	Signature	CC	Description	Source
`diagnose_security`	`diagnose_security()`	4	Diagnostyka bezpieczeństwa systemu i sieci.	source

`fixos.diagnostics.checks.storage_optimization` source

Function	Signature	CC	Description	Source
`diagnose_storage`	`diagnose_storage()`	4	Diagnostyka optymalizacji dysków i partycji.	source

`fixos.diagnostics.checks.system_core` source

Function	Signature	CC	Description	Source
`diagnose_system`	`diagnose_system()`	11 ⚠️	System metrics – cross-platform: CPU, RAM, disks, processes.	source

`fixos.diagnostics.checks.thumbnails` source

Function	Signature	CC	Description	Source
`diagnose_thumbnails`	`diagnose_thumbnails()`	1	Diagnostyka podglądów plików (thumbnails) w system.	source

`fixos.diagnostics.dev_project_analyzer` source

Class	Methods	Description	Source
`DevProjectAnalyzer`	5	Analyze developer projects for dependency folders that can be cleaned.	source
`ProjectDependency`	1	Represents a dependency folder that can be cleaned	source

DevProjectAnalyzer methods:

analyze(max_depth) — Scan home directory for dependency folders.
get_old_dependencies(days) — Get dependencies not modified in X days
get_large_dependencies(min_size_mb) — Get dependencies larger than X MB
get_summary() — Get human-readable summary
get_cleanup_commands() — Get cleanup commands for each dependency

`fixos.diagnostics.disk_analyzer` source

Class	Methods	Description	Source
`DiskAnalyzer`	6	Analyzes disk usage and provides cleanup suggestions	source

DiskAnalyzer methods:

analyze_disk_usage(path) — Comprehensive disk usage analysis
get_large_files(path, min_size_mb, max_files) — Find large files
get_cache_dirs(path, max_dirs) — Find cache directories
get_log_dirs(path, max_dirs) — Find log directories
get_temp_dirs(path, max_dirs) — Find temporary directories
suggest_cleanup_actions(path) — Generate cleanup suggestions using heuristics

Function	Signature	CC	Description	Source
`main`	`main()`	1	Test the disk analyzer	source

`fixos.diagnostics.docker_network_cleanup` source

Class	Methods	Description	Source
`DockerNetworkCleaner`	3	Usuwa wyłącznie sieci bez endpointów i testuje pulę adresową.	source

DockerNetworkCleaner methods:

list_unused(min_age_days) — Zwróć niestandardowe sieci bez endpointów.
probe_address_pool() — Utwórz i usuń tymczasową sieć, potwierdzając dostępność puli.
cleanup() — Usuń dokładnie wykryte sieci i opcjonalnie sprawdź pulę adresową.

`fixos.diagnostics.docker_startup_optimizer` source

Class	Methods	Description	Source
`DockerStartupOptimizer`	2	Find and explicitly disable stale repository-backed Docker autostart.	source

DockerStartupOptimizer methods:

scan(min_inactive_days) — Return evidence and stale candidates without changing Docker state.
optimize(container_ids) — Disable exact stale candidates and optionally stop them.

`fixos.diagnostics.flatpak_analyzer` source

Class	Methods	Description	Source
`FlatpakAnalyzer`	1	Advanced analyzer for Flatpak cleanup decisions	source
`FlatpakItemInfo`	1	Detailed info about a Flatpak item (app, runtime, or data)	source
`FlatpakItemType`	0	—	source

Function	Signature	CC	Description	Source
`analyze_flatpak_for_cleanup`	`analyze_flatpak_for_cleanup()`	1	Convenience function to run full Flatpak analysis	source

`fixos.diagnostics.jetbrains_ai` source

Class	Methods	Description	Source
`JetBrainsAiControl`	5	Inspect or explicitly disable AI plugins and stop exact Qoder helpers.	source
`JetBrainsAiSafetyError`	0	Raised when an AI-control target cannot be proven exact and safe.	source

JetBrainsAiControl methods:

find_qoder_helpers(records)
find_config_dirs(records, explicit)
status()
disable_plugins(config_dir)
stop_qoder_helpers(identities)

`fixos.diagnostics.jetbrains_recovery` source

Class	Methods	Description	Source
`EdtThreadState`	1	—	source
`JetBrainsDiagnosis`	0	—	source
`JetBrainsLogSignals`	1	—	source
`JetBrainsMetrics`	0	—	source
`JetBrainsRecovery`	3	Correlate JetBrains evidence and optionally run a bounded JVM GC.	source
`JetBrainsRecoveryResult`	0	—	source
`JetBrainsRecoverySafetyError`	0	Raised when a recovery request cannot be proven safe and applicable.	source
`JvmHeapInfo`	1	—	source

JetBrainsRecovery methods:

find_main_processes(records)
diagnose(pid)
recover(diagnosis) — Optionally run GC.run and verify evidence without closing the IDE.

Function	Signature	CC	Description	Source
`analyze_idea_log`	`analyze_idea_log(text)`	15 ⚠️	Extract bounded, explainable stall signals from JetBrains log text.	source
`collect_jetbrains_metrics`	`collect_jetbrains_metrics(pid)`	2	—	source
`is_main_jetbrains_process`	`is_main_jetbrains_process(process)`	1	Return true only for a main IDE process, never a helper/server.	source
`jetbrains_product_marker`	`jetbrains_product_marker(process)`	9	Identify a product only from its launcher, never arbitrary arguments.	source
`parse_edt_thread`	`parse_edt_thread(text)`	7	Extract the AWT event-dispatch thread from a `Thread.print` result.	source
`parse_heap_info`	`parse_heap_info(text)`	2	—	source
`read_log_since`	`read_log_since(path, offset)`	3	—	source
`read_log_tail`	`read_log_tail(path)`	2	—	source

`fixos.diagnostics.orphaned_workloads` source

Class	Methods	Description	Source
`OrphanedWorkloadCleaner`	2	Find and explicitly clean missing-project Docker and process workloads.	source
`OrphanedWorkloadSafetyError`	0	Raised when an exact cleanup target no longer satisfies safety checks.	source

OrphanedWorkloadCleaner methods:

scan() — Return exact orphan evidence without changing Docker or processes.
cleanup() — Revalidate and apply only exact selected orphan candidates.

`fixos.diagnostics.process_chains` source

Class	Methods	Description	Source
`FileLockWait`	0	One kernel-reported file-lock dependency.	source
`ProcessChainFinding`	2	A fresh process subtree and the evidence associated with it.	source
`ProcessChainInspector`	4	List, analyse and explicitly terminate recent process subtrees.	source
`ProcessChainSafetyError`	0	Raised when a requested process-tree action fails a safety check.	source
`ProcessRecord`	3	Stable process metadata captured at one point in time.	source
`TerminationResult`	1	Result of a dry run or an attempted tree termination.	source

ProcessChainInspector methods:

snapshot()
list_recent() — Return newest processes first, without classifying them as blockers.
find_suspicious_chains() — Reconstruct fresh trees and attach explainable blocking evidence.
terminate_chain(finding) — Terminate one selected tree after identity and ancestry checks.

ProcessRecord methods:

age_seconds(now)
to_dict()

Function	Signature	CC	Description	Source
`collect_processes`	`collect_processes()`	13 ⚠️	Collect a best-effort process snapshot using the existing psutil dependency.	source
`parse_proc_locks`	`parse_proc_locks(text)`	8	Parse blocked lock requests from Linux `/proc/locks` content.	source
`read_linux_lock_waits`	`read_linux_lock_waits(path)`	2	Read Linux lock dependencies; return no evidence on other/denied systems.	source

`fixos.diagnostics.project_scanner` source

Class	Methods	Description	Source
`ProjectArtifact`	0	A single removable artifact directory found inside a project.	source

Function	Signature	CC	Description	Source
`discover_project_roots`	`discover_project_roots(base, max_depth)`	9	Find developer project roots under `base` (dirs carrying a known	source
`find_duplicate_venvs`	`find_duplicate_venvs(artifacts)`	5	Project paths that carry more than one virtualenv-type artifact at	source
`scan_all`	`scan_all(base, threshold_mb, stale_days, max_depth)`	2	Scan every project under `base` for removable artifacts, largest first.	source
`scan_project_artifacts`	`scan_project_artifacts(project_root, threshold_mb, stale_days)`	7	Find removable artifacts directly under a single project root.	source
`summarize`	`summarize(artifacts)`	9	Aggregate stats used for the CLI summary header.	source

`fixos.diagnostics.quick_snapshot` source

Class	Methods	Description	Source
`CacheRule`	0	—	source

Function	Signature	CC	Description	Source
`collect_quick_snapshot`	`collect_quick_snapshot()`	7	Collect a bounded, heuristic snapshot without using an LLM.	source

`fixos.diagnostics.service_cleanup` source

Class	Methods	Description	Source
`ServiceCleaner`	19	Plans and executes cleanup of service data.	source

ServiceCleaner methods:

docker_old_unused_until_hours(days) — Convert a positive day count to Docker until=<Nh> hours.
get_docker_old_unused_command(days) — Bounded prune: unused images (and old build cache) older than N days.
list_ollama_models() — Return installed Ollama models with name/size/modified_at (UTC).
list_running_ollama_models() — Names of models currently loaded in memory (must not be deleted).
select_old_ollama_models(models, days) — Filter models whose modified_at is older than N days; skip running ones.
cleanup_ollama_old_unused(days, dry_run) — Remove Ollama models not modified for more than N days (skip running).
get_docker_unused_command() — Prune all unused images and rebuildable build cache (no age filter).
cleanup_docker_unused(dry_run) — Remove unused images/cache and optionally orphaned networks.
cleanup_docker_networks(days, dry_run) — Remove unused custom networks and verify Docker address-pool allocation.
cleanup_docker_old_unused(days, dry_run) — Remove old images/cache and optionally orphaned networks.
build_safe_age_actions(selected_services) — Bounded age-based cleanups treated as safe (option [1] in interactive cleanup).
get_cleanup_plan(selected_services) — Generate cleanup plan for services, split into 3 risk tiers.
cleanup_service(service_type, dry_run, planned_service) — Execute cleanup for a specific service or exact planned entry.
get_risk_level(service_type, path) — Classify cleanup risk for a service path.
is_safe_cleanup(service_type, path) — Backward-compatible bool view of get_risk_level() == SAFE.
get_cleanup_hints(service_type, size_gb) — Get helpful hints for cleaning services that require manual review.
get_service_description(service_type) — Get description for service type.
get_cleanup_command(service_type, path) — Get a bounded cleanup command for a scanned service path.
get_preview_command(service_type, path) — Get preview command for service.

`fixos.diagnostics.service_details` source

Class	Methods	Description	Source
`ServiceDetailsProvider`	1	Provides detailed information about service data.	source

`fixos.diagnostics.service_scanner` source

Class	Methods	Description	Source
`RiskLevel`	0	How risky it is to delete a scanned service's data.	source
`ServiceDataInfo`	0	Information about service data.	source
`ServiceDataScanner`	5	Scans for large service data directories and allows cleanup.	source
`ServiceType`	0	Service types that can be scanned and cleaned.	source

ServiceDataScanner methods:

scan_all_services() — Scan all known services for data above threshold.
scan_service(service_type) — Scan specific service type for data.
measure_service_size_mb(service_type, path) — Measure a service with the same source before and after cleanup.
get_cleanup_plan(selected_services) — Generate cleanup plan for services.
cleanup_service(service_type, dry_run, planned_service) — Execute cleanup for a specific service.

Function	Signature	CC	Description	Source
`main`	`main()`	1	Test the service data scanner.	source

`fixos.diagnostics.storage_analyzer` source

Class	Methods	Description	Source
`StorageAnalyzer`	2	Comprehensive storage analyzer for Linux systems.	source
`StorageItem`	1	Represents a storage item that can be cleaned	source

StorageAnalyzer methods:

analyze_full() — Run full system storage analysis
get_summary() — Get human-readable summary

`fixos.diagnostics.system_checks` source

Function	Signature	CC	Description	Source
`get_full_diagnostics`	`get_full_diagnostics(modules, progress_callback)`	12 ⚠️	Zbiera diagnostykę z wybranych modułów.	source

`fixos.diagnostics.utils` source

Function	Signature	CC	Description	Source
`format_size`	`format_size(size_bytes)`	3	Format bytes to human-readable string (B/KB/MB/GB/TB/PB).	source

`fixos.endpoint_refresh` source

Class	Methods	Description	Source
`EndpointStatus`	1	Permission-safe result of one endpoint observation.	source

Function	Signature	CC	Description	Source
`refresh_endpoint`	`refresh_endpoint(name, url)`	26 ⚠️	Observe one endpoint and retain the last good result on DNS failure.	source

`fixos.features` source

Class	Methods	Description	Source
`SystemDetector`	1	Detects system parameters.	source
`SystemInfo`	0	Complete system information snapshot.	source
`AuditResult`	3	Result of feature audit - what's installed, what's missing.	source
`FeatureAuditor`	1	Compares installed packages with profile requirements.	source
`PackageCatalog`	4	Manages the package database.	source
`PackageCategory`	0	A category of packages (e.g., core_utils, dev_tools).	source
`PackageInfo`	2	Information about a single package.	source
`FeatureInstaller`	2	Safely installs packages using native package manager or other backends.	source
`UserProfile`	4	A user profile defining what packages/features they want.	source
`FeatureRenderer`	3	Renders audit results for terminal display.	source

PackageCatalog methods:

load(cls, data_dir) — Load package catalog from YAML files.
get_package(pkg_id) — Get package by ID.
get_packages_by_category(category) — Get all packages in a category.
list_categories() — List all category IDs.

PackageInfo methods:

get_distro_name(distro) — Get package name for specific distro.
is_available_on(distro) — Check if package is available on given distro.

FeatureInstaller methods:

install(packages) — Install a list of packages.
get_rollback_commands(installed_packages) — Generate rollback commands for installed packages.

UserProfile methods:

load(cls, profile_name, data_dir) — Load a profile from YAML file.
list_available(cls, data_dir) — List available profile names.
resolve_packages(catalog, system_info) — Resolve all packages for this profile based on system.
to_dict() — Convert to dictionary.

FeatureRenderer methods:

render_audit(result) — Render complete audit results.
render_package_list(packages, title) — Render a list of packages.
render_system_info(system) — Render system information.

`fixos.features.auditor` source

Class	Methods	Description	Source
`AuditResult`	3	Result of feature audit - what's installed, what's missing.	source
`FeatureAuditor`	1	Compares installed packages with profile requirements.	source

`fixos.features.catalog` source

Class	Methods	Description	Source
`PackageCatalog`	4	Manages the package database.	source
`PackageCategory`	0	A category of packages (e.g., core_utils, dev_tools).	source
`PackageInfo`	2	Information about a single package.	source

PackageCatalog methods:

load(cls, data_dir) — Load package catalog from YAML files.
get_package(pkg_id) — Get package by ID.
get_packages_by_category(category) — Get all packages in a category.
list_categories() — List all category IDs.

PackageInfo methods:

get_distro_name(distro) — Get package name for specific distro.
is_available_on(distro) — Check if package is available on given distro.

`fixos.features.installer` source

Class	Methods	Description	Source
`FeatureInstaller`	2	Safely installs packages using native package manager or other backends.	source

FeatureInstaller methods:

install(packages) — Install a list of packages.
get_rollback_commands(installed_packages) — Generate rollback commands for installed packages.

`fixos.features.profiles` source

Class	Methods	Description	Source
`UserProfile`	4	A user profile defining what packages/features they want.	source

UserProfile methods:

load(cls, profile_name, data_dir) — Load a profile from YAML file.
list_available(cls, data_dir) — List available profile names.
resolve_packages(catalog, system_info) — Resolve all packages for this profile based on system.
to_dict() — Convert to dictionary.

`fixos.features.renderer` source

Class	Methods	Description	Source
`FeatureRenderer`	3	Renders audit results for terminal display.	source

FeatureRenderer methods:

render_audit(result) — Render complete audit results.
render_package_list(packages, title) — Render a list of packages.
render_system_info(system) — Render system information.

`fixos.interactive` source

Class	Methods	Description	Source
`CleanupAction`	0	Represents a cleanup action	source
`CleanupPlanner`	4	Interactive cleanup planning and grouping system	source
`CleanupType`	0	—	source
`Priority`	0	—	source

CleanupPlanner methods:

group_by_category(suggestions) — Group cleanup suggestions by category
prioritize_actions(grouped_actions) — Create prioritized list of all actions
create_cleanup_plan(suggestions) — Create comprehensive cleanup plan
interactive_selection(plan) — Interactive selection process (simulated for now)

Function	Signature	CC	Description	Source
`main`	`main()`	1	Test the cleanup planner	source

`fixos.interactive.cleanup_planner` source

Class	Methods	Description	Source
`CleanupAction`	0	Represents a cleanup action	source
`CleanupPlanner`	4	Interactive cleanup planning and grouping system	source
`CleanupType`	0	—	source
`Priority`	0	—	source

CleanupPlanner methods:

group_by_category(suggestions) — Group cleanup suggestions by category
prioritize_actions(grouped_actions) — Create prioritized list of all actions
create_cleanup_plan(suggestions) — Create comprehensive cleanup plan
interactive_selection(plan) — Interactive selection process (simulated for now)

Function	Signature	CC	Description	Source
`main`	`main()`	1	Test the cleanup planner	source

`fixos.llm_shell` source

Function	Signature	CC	Description	Source
`execute_command`	`execute_command(cmd)`	10	Wykonuje komendę systemową z potwierdzeniem użytkownika.	source
`format_time`	`format_time(seconds)`	1	—	source
`run_llm_shell`	`run_llm_shell(diagnostics_data, token, model, timeout, ...)`	8	Uruchamia interaktywny shell LLM z przekazanymi danymi diagnostycznymi.	source

`fixos.orchestrator` source

Class	Methods	Description	Source
`CommandExecutor`	6	Bezpieczny executor komend z:	source
`CommandTimeoutError`	0	—	source
`DangerousCommandError`	0	—	source
`ExecutionResult`	2	—	source
`Problem`	2	—	source
`ProblemGraph`	7	DAG problemów systemowych z topological sort do wyznaczania kolejności napraw.	source
`FixOrchestrator`	4	Orkiestrator napraw systemowych.	source
`RollbackEntry`	0	Single recorded operation with its rollback command.	source
`RollbackSession`	5	A session of recorded operations that can be rolled back.	source

CommandExecutor methods:

is_dangerous(command) — Sprawdza czy komenda jest potencjalnie destruktywna.
needs_sudo(command)
add_sudo(command)
check_idempotent(command) — Zwraca komendę sprawdzającą stan (jeśli znana), None jeśli nie dotyczy.
execute_sync(command, timeout, add_sudo, check_idempotent) — Synchroniczne wykonanie komendy.
execute(command, timeout, add_sudo) — Asynchroniczne wykonanie komendy.

Problem methods:

is_actionable()
to_summary()

ProblemGraph methods:

add(problem)
get(problem_id)
next_actionable() — Zwraca pierwszy problem bez nierozwiązanych zależności.
all_done()
pending_count()
summary()
render_tree() — Renderuje drzewo problemów jako tekst.

FixOrchestrator methods:

load_from_diagnostics(diagnostics) — Parsuje dane diagnostyczne przez LLM i buduje graf problemów.
load_from_dict(problems_data) — Ładuje problemy bezpośrednio z listy dict (bez LLM).
run_sync(confirm_fn, progress_fn) — Synchroniczna pętla napraw (dla trybu HITL).
run_async(confirm_fn, progress_fn) — Asynchroniczna wersja run_sync.

RollbackSession methods:

record(command, rollback_cmd, stdout, stderr, ...) — Zapisz wykonaną operację.
get_rollback_commands() — Zwraca listę (komenda, rollback) w odwróconej kolejności.
rollback_last(n, dry_run) — Cofnij ostatnich n operacji.
load(cls, session_id) — Załaduj sesję z pliku.
list_sessions(cls, limit) — Lista ostatnich sesji rollback.

`fixos.orchestrator.executor` source

Class	Methods	Description	Source
`CommandExecutor`	6	Bezpieczny executor komend z:	source
`CommandTimeoutError`	0	—	source
`DangerousCommandError`	0	—	source
`ExecutionResult`	2	—	source

CommandExecutor methods:

is_dangerous(command) — Sprawdza czy komenda jest potencjalnie destruktywna.
needs_sudo(command)
add_sudo(command)
check_idempotent(command) — Zwraca komendę sprawdzającą stan (jeśli znana), None jeśli nie dotyczy.
execute_sync(command, timeout, add_sudo, check_idempotent) — Synchroniczne wykonanie komendy.
execute(command, timeout, add_sudo) — Asynchroniczne wykonanie komendy.

`fixos.orchestrator.graph` source

Class	Methods	Description	Source
`Problem`	2	—	source
`ProblemGraph`	7	DAG problemów systemowych z topological sort do wyznaczania kolejności napraw.	source

Problem methods:

is_actionable()
to_summary()

ProblemGraph methods:

add(problem)
get(problem_id)
next_actionable() — Zwraca pierwszy problem bez nierozwiązanych zależności.
all_done()
pending_count()
summary()
render_tree() — Renderuje drzewo problemów jako tekst.

`fixos.orchestrator.orchestrator` source

Class	Methods	Description	Source
`FixOrchestrator`	4	Orkiestrator napraw systemowych.	source

FixOrchestrator methods:

load_from_diagnostics(diagnostics) — Parsuje dane diagnostyczne przez LLM i buduje graf problemów.
load_from_dict(problems_data) — Ładuje problemy bezpośrednio z listy dict (bez LLM).
run_sync(confirm_fn, progress_fn) — Synchroniczna pętla napraw (dla trybu HITL).
run_async(confirm_fn, progress_fn) — Asynchroniczna wersja run_sync.

`fixos.orchestrator.rollback` source

Class	Methods	Description	Source
`RollbackEntry`	0	Single recorded operation with its rollback command.	source
`RollbackSession`	5	A session of recorded operations that can be rolled back.	source

RollbackSession methods:

record(command, rollback_cmd, stdout, stderr, ...) — Zapisz wykonaną operację.
get_rollback_commands() — Zwraca listę (komenda, rollback) w odwróconej kolejności.
rollback_last(n, dry_run) — Cofnij ostatnich n operacji.
load(cls, session_id) — Załaduj sesję z pliku.
list_sessions(cls, limit) — Lista ostatnich sesji rollback.

`fixos.orphan_pins` source

Class	Methods	Description	Source
`OrphanProjectPinError`	0	Raised when persistent pin state cannot be trusted.	source
`OrphanProjectPins`	4	Read and atomically update exact Compose working-directory pins.	source

OrphanProjectPins methods:

list() — Load validated records, failing closed if the state is malformed.
paths() — Return exact normalized paths used by the scanner.
pin(value) — Persist one exact path and report whether state changed.
unpin(value) — Remove one exact path, leaving unrelated pins untouched.

Function	Signature	CC	Description	Source
`default_pin_path`	`default_pin_path()`	2	Return the XDG-compliant per-user pin store path.	source
`normalize_project_path`	`normalize_project_path(value)`	3	Return a stable absolute path without requiring the path to exist.	source

`fixos.platform_utils` source

Function	Signature	CC	Description	Source
`cancel_signal_timeout`	`cancel_signal_timeout()`	2	Cancels the timeout signal (POSIX only).	source
`elevate_cmd`	`elevate_cmd(cmd)`	3	Adds sudo (Linux/Mac) or wraps in PowerShell -Verb RunAs (Windows).	source
`get_os_info`	`get_os_info()`	5	Returns basic OS information.	source
`get_package_manager`	`get_package_manager()`	8	Detects the system package manager.	source
`install_package_cmd`	`install_package_cmd(package)`	2	Returns the install command for the detected package manager.	source
`is_dangerous`	`is_dangerous(cmd)`	3	Returns reason string if command is dangerous, None if safe.	source
`is_interactive_blocker`	`is_interactive_blocker(cmd)`	3	Returns reason string if command is likely to hang in non-interactive session.	source
`needs_elevation`	`needs_elevation(cmd)`	5	Returns True if command likely needs admin/sudo.	source
`run_command`	`run_command(cmd, timeout, shell)`	5	Runs a command cross-platform.	source
`setup_signal_timeout`	`setup_signal_timeout(seconds, handler)`	2	Sets up a timeout signal. Returns True if supported (POSIX only).	source

`fixos.plugins` source

Class	Methods	Description	Source
`DiagnosticPlugin`	3	Bazowa klasa dla pluginów diagnostycznych fixOS.	source
`DiagnosticResult`	1	Result of a diagnostic plugin run.	source
`Finding`	0	Single finding from a diagnostic plugin.	source
`Severity`	0	Severity level for diagnostic findings.	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`PluginRegistry`	6	Registry for diagnostic plugins with autodiscovery.	source

DiagnosticPlugin methods:

diagnose() — Wykonaj diagnostykę i zwróć wynik.
can_run() — Czy plugin może działać na aktualnej platformie?
get_metadata()

PluginRegistry methods:

discover() — Odkrywanie pluginów przez builtin + entry_points.
register(plugin) — Ręczna rejestracja pluginu.
list_plugins(runnable_only) — Lista zarejestrowanych pluginów.
get_plugin(name) — Pobierz plugin po nazwie.
run(modules, progress_callback) — Uruchom diagnostykę dla wybranych (lub wszystkich) modułów.

`fixos.plugins.base` source

Class	Methods	Description	Source
`DiagnosticPlugin`	3	Bazowa klasa dla pluginów diagnostycznych fixOS.	source
`DiagnosticResult`	1	Result of a diagnostic plugin run.	source
`Finding`	0	Single finding from a diagnostic plugin.	source
`Severity`	0	Severity level for diagnostic findings.	source

DiagnosticPlugin methods:

diagnose() — Wykonaj diagnostykę i zwróć wynik.
can_run() — Czy plugin może działać na aktualnej platformie?
get_metadata()

`fixos.plugins.builtin` source

Class	Methods	Description	Source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source
`Plugin`	1	—	source

`fixos.plugins.builtin.audio` source

Class	Methods	Description	Source
`Plugin`	1	—	source

`fixos.plugins.builtin.disk` source

Class	Methods	Description	Source
`Plugin`	1	—	source

`fixos.plugins.builtin.hardware` source

Class	Methods	Description	Source
`Plugin`	1	—	source

`fixos.plugins.builtin.resources` source

Class	Methods	Description	Source
`Plugin`	1	—	source

`fixos.plugins.builtin.security` source

Class	Methods	Description	Source
`Plugin`	1	—	source

`fixos.plugins.builtin.thumbnails` source

Class	Methods	Description	Source
`Plugin`	1	—	source

`fixos.plugins.registry` source

Class	Methods	Description	Source
`PluginRegistry`	6	Registry for diagnostic plugins with autodiscovery.	source

PluginRegistry methods:

discover() — Odkrywanie pluginów przez builtin + entry_points.
register(plugin) — Ręczna rejestracja pluginu.
list_plugins(runnable_only) — Lista zarejestrowanych pluginów.
get_plugin(name) — Pobierz plugin po nazwie.
run(modules, progress_callback) — Uruchom diagnostykę dla wybranych (lub wszystkich) modułów.

`fixos.profiles` source

Class	Methods	Description	Source
`Profile`	3	Profil diagnostyczny z zestawem modułów i progów.	source

Profile methods:

load(cls, name) — Załaduj profil — najpierw user, potem builtin.
list_available(cls) — Lista dostępnych profili (builtin + user).
to_dict()

`fixos.providers` source

Class	Methods	Description	Source
`LLMClient`	6	Wrapper nad openai.OpenAI kompatybilny z wieloma providerami.	source
`LLMError`	0	Błąd komunikacji z LLM.	source
`LLMAnalysis`	0	Result of LLM analysis	source
`LLMAnalyzer`	4	Uses LLM to analyze disk issues when heuristics aren't sufficient	source
`CommandValidation`	0	Wynik walidacji komendy przez LLM.	source
`FixSuggestion`	0	Pojedyncza sugestia naprawy od LLM.	source
`LLMDiagnosticResponse`	0	Strukturalna odpowiedź LLM na dane diagnostyczne.	source
`NLPIntent`	0	Rozpoznana intencja z polecenia NLP.	source
`RiskLevel`	0	—	source

LLMClient methods:

chat(messages) — Wysyła wiadomości do LLM i zwraca odpowiedź jako string.
chat_stream(messages) — Generator streamujący tokeny odpowiedzi.
chat_structured(messages, response_model) — Wywołanie LLM z wymuszonym schematem JSON (Pydantic model).
ping() — Sprawdza czy API odpowiada (krótki test).

LLMAnalyzer methods:

analyze_disk_issues(disk_data) — Use LLM to analyze disk issues when heuristics are insufficient
analyze_failed_action(action, error) — Analyze failed cleanup action and suggest alternatives
analyze_complex_pattern(pattern_data) — Analyze complex disk usage patterns that heuristics can't categorize
enhance_heuristics_with_llm(heuristic_suggestions, disk_data) — Enhance heuristic suggestions with LLM insights

Function	Signature	CC	Description	Source
`main`	`main()`	1	Test the LLM analyzer	source

`fixos.providers.llm` source

Class	Methods	Description	Source
`LLMClient`	6	Wrapper nad openai.OpenAI kompatybilny z wieloma providerami.	source
`LLMError`	0	Błąd komunikacji z LLM.	source

LLMClient methods:

chat(messages) — Wysyła wiadomości do LLM i zwraca odpowiedź jako string.
chat_stream(messages) — Generator streamujący tokeny odpowiedzi.
chat_structured(messages, response_model) — Wywołanie LLM z wymuszonym schematem JSON (Pydantic model).
ping() — Sprawdza czy API odpowiada (krótki test).

`fixos.providers.llm_analyzer` source

Class	Methods	Description	Source
`LLMAnalysis`	0	Result of LLM analysis	source
`LLMAnalyzer`	4	Uses LLM to analyze disk issues when heuristics aren't sufficient	source

LLMAnalyzer methods:

analyze_disk_issues(disk_data) — Use LLM to analyze disk issues when heuristics are insufficient
analyze_failed_action(action, error) — Analyze failed cleanup action and suggest alternatives
analyze_complex_pattern(pattern_data) — Analyze complex disk usage patterns that heuristics can't categorize
enhance_heuristics_with_llm(heuristic_suggestions, disk_data) — Enhance heuristic suggestions with LLM insights

Function	Signature	CC	Description	Source
`main`	`main()`	1	Test the LLM analyzer	source

`fixos.providers.schemas` source

Class	Description	Source
`CommandValidation`	Wynik walidacji komendy przez LLM.	source
`FixSuggestion`	Pojedyncza sugestia naprawy od LLM.	source
`LLMDiagnosticResponse`	Strukturalna odpowiedź LLM na dane diagnostyczne.	source
`NLPIntent`	Rozpoznana intencja z polecenia NLP.	source
`RiskLevel`	—	source

`fixos.system_checks` source

Function	Signature	CC	Description	Source
`get_cpu_info`	`get_cpu_info()`	2	Metryki CPU.	source
`get_disk_info`	`get_disk_info()`	3	Metryki dysków dla wszystkich partycji.	source
`get_fedora_specific`	`get_fedora_specific()`	1	Komendy specyficzne dla system: dnf, journalctl, systemctl.	source
`get_full_diagnostics`	`get_full_diagnostics()`	1	Zbiera kompletne dane diagnostyczne systemu system.	source
`get_memory_info`	`get_memory_info()`	1	Metryki RAM i SWAP.	source
`get_network_info`	`get_network_info()`	4	Statystyki sieciowe (bez wrażliwych danych - anonimizacja jest osobno).	source
`get_top_processes`	`get_top_processes(n)`	3	Lista TOP N procesów według zużycia CPU.	source
`run_cmd`	`run_cmd(cmd, timeout)`	6	Uruchamia komendę shell i zwraca output. Bezpieczny fallback przy błędzie.	source

`fixos.utils` source

Class	Methods	Description	Source
`AnonymizationContext`	3	Memory-only alias state. Never include this object in LLM payloads.	source
`AnonymizationReport`	2	Raport anonimizacji – co zostało zmaskowane.	source
`ResolutionError`	0	Raised when an anonymized alias cannot be resolved safely.	source
`SessionTimeout`	0	Wyjątek rzucany po przekroczeniu limitu czasu sesji.	source
`SearchResult`	0	—	source

AnonymizationContext methods:

bind(category, original, token)
numbered_alias(category, original)
user_alias(username)

AnonymizationReport methods:

add(category, count)
summary()

Function	Signature	CC	Description	Source
`anonymize`	`anonymize(data_str, context)`	7	Anonimizuje wrażliwe dane.	source
`deanonymize`	`deanonymize(text, context, allowed_aliases)`	3	Resolve aliases locally while preserving the legacy primary tokens.	source
`display_anonymized_preview`	`display_anonymized_preview(data_str, report, max_lines)`	5	Wyświetla użytkownikowi zanonimizowane dane przed wysłaniem do LLM.	source
`colorize`	`colorize(line)`	1	Return line unchanged – rich handles markup in render_md().	source
`print_cmd_block`	`print_cmd_block(cmd, comment, dry_run)`	4	Print a framed command preview panel.	source
`print_problem_header`	`print_problem_header(problem_id, description, severity, status, ...)`	3	Print a colored problem header panel.	source
`print_stderr_box`	`print_stderr_box(stderr, max_lines)`	1	Print stderr in a rich Panel.	source
`print_stdout_box`	`print_stdout_box(stdout, max_lines)`	1	Print stdout in a rich Panel.	source
`render_md`	`render_md(text)`	9	Print LLM markdown reply to terminal via rich.	source
`render_tree_colored`	`render_tree_colored(nodes, execution_order)`	8	Render a ProblemGraph as a rich-markup string.	source
`timeout_handler`	`timeout_handler(signum, frame)`	1	Signal handler dla SIGALRM — rzuca SessionTimeout.	source
`format_results_for_llm`	`format_results_for_llm(results)`	3	Formatuje wyniki wyszukiwania do wklejenia w prompt LLM.	source
`search_all`	`search_all(query, serpapi_key, max_per_source)`	5	Przeszukuje wszystkie dostępne źródła wiedzy.	source
`search_arch_wiki`	`search_arch_wiki(query, max_results)`	9	Arch Wiki – doskonałe źródło dla problemów Linux (nie tylko Arch).	source
`search_ask_fedora`	`search_ask_fedora(query, max_results)`	4	Szuka w Linux forums przez Discourse API.	source
`search_ddg`	`search_ddg(query, max_results)`	8	DuckDuckGo Instant Answer API (bez klucza, ograniczone).	source
`search_fedora_bugzilla`	`search_fedora_bugzilla(query, max_results)`	4	Szuka w Linux Bugzilla przez REST API.	source
`search_github_issues`	`search_github_issues(query, max_results)`	4	GitHub Issues – linuxhardware, ALSA, PipeWire, PulseAudio repos.	source
`search_serpapi`	`search_serpapi(query, api_key, max_results)`	5	SerpAPI – Google/Bing search (wymaga klucza API).	source

`fixos.utils.anonymizer` source

Class	Methods	Description	Source
`AnonymizationContext`	3	Memory-only alias state. Never include this object in LLM payloads.	source
`AnonymizationReport`	2	Raport anonimizacji – co zostało zmaskowane.	source
`ResolutionError`	0	Raised when an anonymized alias cannot be resolved safely.	source

AnonymizationContext methods:

bind(category, original, token)
numbered_alias(category, original)
user_alias(username)

AnonymizationReport methods:

add(category, count)
summary()

Function	Signature	CC	Description	Source
`anonymize`	`anonymize(data_str, context)`	7	Anonimizuje wrażliwe dane.	source
`deanonymize`	`deanonymize(text, context, allowed_aliases)`	3	Resolve aliases locally while preserving the legacy primary tokens.	source
`display_anonymized_preview`	`display_anonymized_preview(data_str, report, max_lines)`	5	Wyświetla użytkownikowi zanonimizowane dane przed wysłaniem do LLM.	source

`fixos.utils.terminal` source

Function	Signature	CC	Description	Source
`colorize`	`colorize(line)`	1	Return line unchanged – rich handles markup in render_md().	source
`print_cmd_block`	`print_cmd_block(cmd, comment, dry_run)`	4	Print a framed command preview panel.	source
`print_problem_header`	`print_problem_header(problem_id, description, severity, status, ...)`	3	Print a colored problem header panel.	source
`print_stderr_box`	`print_stderr_box(stderr, max_lines)`	1	Print stderr in a rich Panel.	source
`print_stdout_box`	`print_stdout_box(stdout, max_lines)`	1	Print stdout in a rich Panel.	source
`render_md`	`render_md(text)`	9	Print LLM markdown reply to terminal via rich.	source
`render_tree_colored`	`render_tree_colored(nodes, execution_order)`	8	Render a ProblemGraph as a rich-markup string.	source

`fixos.utils.timeout` source

Class	Methods	Description	Source
`SessionTimeout`	0	Wyjątek rzucany po przekroczeniu limitu czasu sesji.	source

Function	Signature	CC	Description	Source
`timeout_handler`	`timeout_handler(signum, frame)`	1	Signal handler dla SIGALRM — rzuca SessionTimeout.	source

`fixos.utils.web_search` source

Class	Methods	Description	Source
`SearchResult`	0	—	source

Function	Signature	CC	Description	Source
`format_results_for_llm`	`format_results_for_llm(results)`	3	Formatuje wyniki wyszukiwania do wklejenia w prompt LLM.	source
`search_all`	`search_all(query, serpapi_key, max_per_source)`	5	Przeszukuje wszystkie dostępne źródła wiedzy.	source
`search_arch_wiki`	`search_arch_wiki(query, max_results)`	9	Arch Wiki – doskonałe źródło dla problemów Linux (nie tylko Arch).	source
`search_ask_fedora`	`search_ask_fedora(query, max_results)`	4	Szuka w Linux forums przez Discourse API.	source
`search_ddg`	`search_ddg(query, max_results)`	8	DuckDuckGo Instant Answer API (bez klucza, ograniczone).	source
`search_fedora_bugzilla`	`search_fedora_bugzilla(query, max_results)`	4	Szuka w Linux Bugzilla przez REST API.	source
`search_github_issues`	`search_github_issues(query, max_results)`	4	GitHub Issues – linuxhardware, ALSA, PipeWire, PulseAudio repos.	source
`search_serpapi`	`search_serpapi(query, api_key, max_results)`	5	SerpAPI – Google/Bing search (wymaga klucza API).	source

`fixos.watch` source

Class	Methods	Description	Source
`WatchDaemon`	2	Daemon wykonujący cykliczną diagnostykę z powiadomieniami.	source

WatchDaemon methods:

run() — Główna pętla monitorowania.
stop() — Zatrzymaj daemon.

scripts

`scripts.pyqual-calibrate` source

Function	Signature	CC	Description	Source
`calculate_new_threshold`	`calculate_new_threshold(actual_value, current_threshold, margin_percent, is_upper_limit)`	3	Wylicza nowy próg z marginesem.	source
`calibrate`	`calibrate(workdir, margin, dry_run, force, ...)`	14 ⚠️	Główna funkcja kalibracji.	source
`extract_current_metrics`	`extract_current_metrics(content)`	4	Wyciąga aktualne progi z YAML.	source
`main`	`main()`	6	—	source
`parse_pyqual_yaml`	`parse_pyqual_yaml(config_path)`	1	Odczytuje zawartość pyqual.yaml.	source
`read_last_metrics_from_db`	`read_last_metrics_from_db(workdir)`	6	Czyta ostatnie metryki z pipeline.db pyqual.	source
`update_metric`	`update_metric(content, metric_name, new_value)`	4	Aktualizuje wartość metryki w YAML.	source

`scripts.runtime` source

Function	Signature	CC	Description	Source
`approvalScopeDigest`	`approvalScopeDigest()`	—	—	source
`canonical`	`canonical()`	—	—	source
`diagnostic`	`diagnostic()`	—	—	source
`exactStringSet`	`exactStringSet()`	—	—	source
`expectedVerdict`	`expectedVerdict()`	—	—	source
`findNumericScore`	`findNumericScore()`	—	—	source
`git`	`git()`	—	—	source
`globToRegExp`	`globToRegExp()`	—	—	source
`isDigest`	`isDigest()`	—	—	source
`isObject`	`isObject()`	—	—	source
`isSha`	`isSha()`	—	—	source
`markdownReport`	`markdownReport()`	—	—	source
`parseOptions`	`parseOptions()`	—	—	source
`pathAllowed`	`pathAllowed()`	—	—	source
`readJson`	`readJson()`	—	—	source
`readText`	`readText()`	—	—	source
`sha256Bytes`	`sha256Bytes()`	—	—	source
`sha256File`	`sha256File()`	—	—	source
`sortDeep`	`sortDeep()`	—	—	source
`usage`	`usage()`	—	—	source
`validateEvaluation`	`validateEvaluation()`	—	—	source
`validateMinimumShape`	`validateMinimumShape()`	—	—	source
`validatePolicyText`	`validatePolicyText()`	—	—	source
`writeResult`	`writeResult()`	—	—	source

FilesExpand file tree

api.md

Latest commit

History

api.md

File metadata and controls

fixos — API Reference

Contents

Core

fixos source

docker

docker.test-multi-system source

docker.test-scenarios source

docker.validate-scenario source

docs

docs.examples.quickstart source

fixos

fixos.agent source

fixos.agent.autonomous source

fixos.agent.autonomous_session source

fixos.agent.hitl source

fixos.agent.hitl_session source

fixos.agent.session_core source

fixos.agent.session_handlers source

fixos.agent.session_io source

fixos.anonymizer source

fixos.cli source

fixos.cli.ask_cmd source

fixos.cli.cleanup_cmd source

fixos.cli.config_cmd source

fixos.cli.features_cmd source

fixos.cli.fix_cmd source

fixos.cli.history_cmd source

fixos.cli.jetbrains_cmd source

fixos.cli.main source

fixos.cli.orchestrate_cmd source

fixos.cli.output_formatter source

fixos.cli.profile_cmd source

fixos.cli.projects_cmd source

fixos.cli.provider_cmd source

fixos.cli.quick_cmd source

fixos.cli.quickfix_cmd source

fixos.cli.report_cmd source

fixos.cli.rollback_cmd source

fixos.cli.scan_cmd source

fixos.cli.shared source

fixos.cli.shell_cmd source

fixos.cli.token_cmd source

fixos.cli.watch_cmd source

fixos.config source

fixos.config_interactive source

fixos.diagnostics source

fixos.diagnostics.cache_discovery source

fixos.diagnostics.checks.audio source

fixos.diagnostics.checks.file_analysis source

fixos.diagnostics.checks.hardware source

fixos.diagnostics.checks.packages source

fixos.diagnostics.checks.resources source

fixos.diagnostics.checks.security source

fixos.diagnostics.checks.storage_optimization source

fixos.diagnostics.checks.system_core source

fixos.diagnostics.checks.thumbnails source

fixos.diagnostics.dev_project_analyzer source

fixos.diagnostics.disk_analyzer source

fixos.diagnostics.docker_network_cleanup source

fixos.diagnostics.docker_startup_optimizer source

fixos.diagnostics.flatpak_analyzer source

fixos.diagnostics.jetbrains_ai source

fixos.diagnostics.jetbrains_recovery source

fixos.diagnostics.orphaned_workloads source

fixos.diagnostics.process_chains source

fixos.diagnostics.project_scanner source

fixos.diagnostics.quick_snapshot source

fixos.diagnostics.service_cleanup source

fixos.diagnostics.service_details source

fixos.diagnostics.service_scanner source

fixos.diagnostics.storage_analyzer source

fixos.diagnostics.system_checks source

fixos.diagnostics.utils source

fixos.endpoint_refresh source

`fixos` source

`docker.test-multi-system` source

`docker.test-scenarios` source

`docker.validate-scenario` source

`docs.examples.quickstart` source

`fixos.agent` source

`fixos.agent.autonomous` source

`fixos.agent.autonomous_session` source

`fixos.agent.hitl` source

`fixos.agent.hitl_session` source

`fixos.agent.session_core` source

`fixos.agent.session_handlers` source

`fixos.agent.session_io` source

`fixos.anonymizer` source

`fixos.cli` source

`fixos.cli.ask_cmd` source

`fixos.cli.cleanup_cmd` source

`fixos.cli.config_cmd` source

`fixos.cli.features_cmd` source

`fixos.cli.fix_cmd` source

`fixos.cli.history_cmd` source

`fixos.cli.jetbrains_cmd` source

`fixos.cli.main` source

`fixos.cli.orchestrate_cmd` source

`fixos.cli.output_formatter` source

`fixos.cli.profile_cmd` source

`fixos.cli.projects_cmd` source

`fixos.cli.provider_cmd` source

`fixos.cli.quick_cmd` source

`fixos.cli.quickfix_cmd` source

`fixos.cli.report_cmd` source

`fixos.cli.rollback_cmd` source

`fixos.cli.scan_cmd` source

`fixos.cli.shared` source

`fixos.cli.shell_cmd` source

`fixos.cli.token_cmd` source

`fixos.cli.watch_cmd` source

`fixos.config` source

`fixos.config_interactive` source

`fixos.diagnostics` source

`fixos.diagnostics.cache_discovery` source

`fixos.diagnostics.checks.audio` source

`fixos.diagnostics.checks.file_analysis` source

`fixos.diagnostics.checks.hardware` source

`fixos.diagnostics.checks.packages` source

`fixos.diagnostics.checks.resources` source

`fixos.diagnostics.checks.security` source

`fixos.diagnostics.checks.storage_optimization` source

`fixos.diagnostics.checks.system_core` source

`fixos.diagnostics.checks.thumbnails` source

`fixos.diagnostics.dev_project_analyzer` source

`fixos.diagnostics.disk_analyzer` source

`fixos.diagnostics.docker_network_cleanup` source

`fixos.diagnostics.docker_startup_optimizer` source

`fixos.diagnostics.flatpak_analyzer` source

`fixos.diagnostics.jetbrains_ai` source

`fixos.diagnostics.jetbrains_recovery` source

`fixos.diagnostics.orphaned_workloads` source

`fixos.diagnostics.process_chains` source

`fixos.diagnostics.project_scanner` source

`fixos.diagnostics.quick_snapshot` source

`fixos.diagnostics.service_cleanup` source

`fixos.diagnostics.service_details` source

`fixos.diagnostics.service_scanner` source

`fixos.diagnostics.storage_analyzer` source

`fixos.diagnostics.system_checks` source

`fixos.diagnostics.utils` source

`fixos.endpoint_refresh` source

`fixos.features` source

`fixos.features.auditor` source

`fixos.features.catalog` source

`fixos.features.installer` source

`fixos.features.profiles` source

`fixos.features.renderer` source

`fixos.interactive` source

`fixos.interactive.cleanup_planner` source

`fixos.llm_shell` source

`fixos.orchestrator` source

`fixos.orchestrator.executor` source

`fixos.orchestrator.graph` source