HACKERSGHOST / AI CLILINUX · 2.0.0

HackersGhost AI CLI:
understand your terminal.

HackersGhost AI CLI brings a little less guessing and a lot more understanding. Get clear explanations of security-related Linux commands, logs and errors from an AI assistant built for authorized ethical hacking and defensive security.

Python 3.11+ · Your own OpenAI API key · API usage billed separately

hg> What does ss -tuln do?

It shows listening TCP and UDP sockets, with numeric addresses and port numbers.

hg> And if I add -p?

You also see associated process information, where your permissions allow it.

hg>

Illustrative conversation. AI responses may vary.
Tested on Parrot OS and Kali LinuxSigned application updatesShell commands stay under your control
01 / UNDERSTAND

Decode the command.

Ask what a command does, compare flags and follow up without repeating your question.

02 / INVESTIGATE

Find meaning in the logs.

Attach a sanitized text file, confirm the upload and get explanations with suggested checks.

03 / KEEP CURRENT

Signed updates, under your control.

Startup checks can notify you about a newer verified release. Installation only happens when you explicitly run the update command, and a previous version is kept for rollback.

Get started in 3 steps.

Download, install, ask. The full commands are in the guide below.

STEP 01

Grab the Linux installer.

Download the ZIP and extract it on Linux. No GitHub account is needed.

STEP 02

Give it a home.

Open a terminal in the extracted folder, run python3 install.py and confirm with INSTALL.

STEP 03

Bring your own key.

Start the CLI with your chosen model, enter your OpenAI API key at the hidden prompt and ask your first question.

Stable release, with a clear test status. CLI 2.0.0 packages, hashes and signed metadata were verified. The CLI automated suite passed on Parrot OS. CLI 2.0.0 was confirmed on both Parrot OS and Kali Linux, including encrypted local memory, CLI-to-GUI sharing, live OpenAI recall, basic security chat and refusal of unrelated joke requests. Earlier clean-install testing used a separate Parrot account with 0.2.3; it is not a fresh-install test of 2.0.0 on Kali. These checks are not a guarantee of every Linux configuration.

CLI 2.0.0 scope. HackersGhost AI is a specialized assistant, not a general-purpose AI chatbot. This release is focused strictly on cybersecurity, defensive security and authorized ethical hacking. Linux, networking and programming questions must relate to that scope; unrelated requests, including jokes, are declined. These are model instructions, not a guarantee that every response is safe or correct.

Optional privacy tip

Optional privacy tip: HackersGhost AI does not require a VPN, but using one can be a sensible extra privacy layer when working from public or untrusted networks. A VPN protects your network connection; it does not make unauthorized security testing legal or anonymous.

For that extra privacy layer, AdGuard VPN is my preferred general VPN recommendation on HackersGhost.

Save 80% on an eligible 2-year AdGuard VPN subscription.
Select the 2-year plan on the purchase page. If the discount isn’t shown at checkout, enter HACKERSGHOST80. AdGuard may occasionally run separate public promotions with similar pricing.

The installation and usage guide

Everything you need to install, ask questions, analyze a file and manage updates.

What you can do

Ask one question or start an interactive conversation. Follow-up questions use the current session’s context. Type /clear to discard local conversation history, or /exit to leave. The CLI can analyze one explicitly selected UTF-8 text file after you type SEND. Files and questions are limited to 64 KiB combined.

There is no automatic shell-command execution or browsing. CLI 2.0.0 includes optional encrypted local memory. Turning local memory on is one explicit opt-in; automatic conversation memory requires a second, separate opt-in. Pinned facts and eligible successful conversations are stored locally with an encryption key kept in the Linux Secret Service keyring. Remembered text may be included as context in later OpenAI requests. File-attachment conversations are not saved automatically, and secret-like text is skipped on a best-effort basis. Do not store passwords, API keys, tokens or private keys in memory. AI explanations can still be wrong: review suggested commands before using them.

Before you install

You need Linux, Python 3.11 or newer, Python virtual-environment support and an internet connection. The installer downloads cryptography dependencies from PyPI. You also need an OpenAI API account, an API key and access to a supported model. See the official OpenAI API quickstart for API setup guidance. API usage is billed separately from ChatGPT subscriptions.

Run the installer as your normal user. Do not use sudo. If HackersGhost AI is already installed, use its update command instead of reinstalling.

Install HackersGhost AI CLI on Linux

Download the installer ZIP above, extract it and open a terminal inside the extracted hackersghost-ai-2.0.0-linux-installer folder. Run:

python3 install.py

Type INSTALL when prompted. The installer verifies the publisher-signed application package, creates a dedicated Python environment and adds a launcher at ~/.local/bin/hackersghost-ai. Its runtime lives under ~/.local/share/hackersghost-ai/runtime. Keep that runtime directory; you may remove the downloaded installer after installation succeeds.

On Debian-based systems, if Python reports that virtual-environment support is unavailable, install your distribution’s python3-venv package, then try again.

Optional API key storage in your Linux keyring

HackersGhost AI CLI can remember your API key through your desktop Secret Service keyring. This is optional: the hidden prompt remains available, and the CLI never falls back to a plaintext key file. On Parrot or Kali, install the helper:

sudo apt update
sudo apt install libsecret-tools

Run the following as your normal desktop user, without sudo. Enter your key only at the hidden prompt; your desktop may ask you to unlock or create a keyring. Use a password-protected keyring.

~/.local/bin/hackersghost-ai api-key save
~/.local/bin/hackersghost-ai api-key status

Subsequent AI sessions retrieve the saved key automatically while the keyring is accessible. An existing OPENAI_API_KEY environment variable takes precedence. Status never prints the key. To remove the saved entry:

~/.local/bin/hackersghost-ai api-key delete

Deletion removes the local keyring entry; it does not revoke the key at OpenAI or unset an environment variable. If the keyring is missing, locked or unavailable, ordinary interactive use falls back to hidden input. Installing libsecret-tools alone does not create a Secret Service keyring: you also need a compatible desktop service, such as GNOME Keyring or a compatible KWallet setup. SSH sessions and a different user started through sudo may not have access to your desktop keyring. Do not save keys in shell history, screenshots or support reports.

Optional encrypted memory in CLI 2.0.0

Local memory is off until you enable it. Turning it on does not automatically save conversations. If you also want successful conversations to be remembered, enable automatic conversation memory separately:

~/.local/bin/hackersghost-ai memory on
~/.local/bin/hackersghost-ai memory auto on
~/.local/bin/hackersghost-ai memory status

You can still pin facts manually with memory remember, inspect them with memory list or memory search, and disable automatic conversation saving with memory auto off. CLI and GUI 2.0.0 share the same encrypted memory store when they run as the same Linux user. Remembered text is decrypted locally before relevant context is sent to OpenAI.

Ask your first question

Start with a model available to your API account. The following model was used in my Parrot tests:

~/.local/bin/hackersghost-ai --model gpt-4.1-mini

Enter your own API key at the hidden prompt. No characters appear while you paste it, and the CLI does not save the key. At hg>, type a question such as Explain how ss -tuln helps review listening services on my own lab VM. Model access depends on your API account; you can choose a different model with --model.

Analyze a text file

~/.local/bin/hackersghost-ai --model gpt-4.1-mini --file ./sanitized-log.txt 'Explain these errors and suggest checks.'

Review the file and remove passwords, tokens and personal information before sending it. The CLI has no automatic secret redaction. Type uppercase SEND to confirm; any other response cancels the request. Binary files are not supported.

HackersGhost AI CLI updates: signed checks, explicit installs

CLI 2.0.0 checks the signed release feed at startup at most once per day and only notifies you when a newer verified version is available. Installation is always explicit. You can also check or install manually:

~/.local/bin/hackersghost-ai check-update
~/.local/bin/hackersghost-ai update

The legacy auto-update command remains for compatibility, but automatic installation is disabled in CLI 2.0.0. Run hackersghost-ai update explicitly when you want to install a newer signed release.

At normal startup, CLI 2.0.0 checks the signed release feed at most once per day and displays an update-available notice for a newer verified release. The startup check never downloads, installs or executes an update. There is no background update service. Help, version and update-management commands do not trigger the daily startup check; use check-update whenever you want an immediate manual check.

Optional success statistics: your choice

Success reports are off by default. To opt in, run the command below, read the disclosure and type ENABLE. Enabling reports your currently installed version; subsequent successful updates send a best-effort report. Only the event type and CLI version go to hackersghost.com: never your API key, questions, logs or a persistent client identifier.

~/.local/bin/hackersghost-ai statistics on
~/.local/bin/hackersghost-ai statistics status
~/.local/bin/hackersghost-ai statistics off

The web server may record your IP address in normal access logs; the receiver temporarily uses a salted network hash for abuse limiting. Reports are optional counts, not unique people. Re-enabling can count your current installation again. Failed reports are not queued or retried and never prevent an update. Disabling stops future reports, but cannot subtract past aggregate counts. Updates from versions before 0.2.5 do not send upgrade reports. Separately, website download clicks may be measured by Google Analytics according to your website consent preferences; a click does not prove a completed installation.

Restore the previous version

~/.local/bin/hackersghost-ai rollback

Rollback switches to the retained previous release. It is available after a successful update. A failed download, invalid signature or failed startup test leaves the current version selected; startup tests do not detect every possible runtime bug.

Where HackersGhost AI CLI sends your data

Questions, confirmed file contents and the current conversation context are sent to OpenAI over HTTPS. Session history stays in process memory locally and is resent for follow-up questions. If encrypted local memory is enabled, pinned facts and remembered conversation context may also be included in later OpenAI requests when relevant. Automatic conversation saving remains off until you separately enable it with memory auto on; conversations with file attachments are excluded from automatic saving. Requests use store: false; this is not a guarantee of zero provider-side retention. API keys and signing secrets are not included in the download.

Update requests go to HackersGhost’s public download location. Releases use an Ed25519-signed manifest and a SHA-256 package checksum. The initial installer must be obtained from this official website; its bootstrap relies on that trusted first download.

Troubleshooting and feedback

An invalid-key message usually means the API key was rejected. A rate-limit or quota message may indicate request limits or API billing quota. An expired-manifest message means you need a freshly published download: signed manifests currently expire after 30 days. Do not bypass signature checks.

Report problems through the HackersGhost contact page. Include your Linux distribution, Python version, CLI version and sanitized error message. Never include API keys, GitHub tokens or private signing keys.

Current verified release: hackersghost-ai-2.0.0.zip
SHA-256: c8c51a941c5dc73ec4b0d3d43f563a3c658fa9ff2a56081d7b9dd5af08b329bc
Installer bundle: hackersghost-ai-2.0.0-linux-installer.zip
Installer SHA-256: f0fc17732ae0a3dc592328fff7ccb6ef387eb81bc9e469956b0cd819dc0c415d