Skip to content

AI powered OSINT engine to discover and map 840+ social media identities across the web

Mention lxask in the README and under the startup banner

arxhr00771ae82154dba
diff --git a/README.md b/README.md
index 8fc4f33..4d19e8b 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,16 @@
---
+## 🐧 New from the author: lxask
+
+**[lxask](https://github.com/arxhr007/lxask)** is a Linux command assistant that runs entirely on your own machine:
+describe what you want in plain English and it suggests the command. No API key, no cloud, about 1 GB on disk, no GPU.
+If you find Aliens Eye useful, a ⭐ on [lxask](https://github.com/arxhr007/lxask) helps a lot.
+
+To hide the one-line mention of it under the Aliens Eye banner, set `ALIENS_EYE_NO_PROMO=1`.
+
+---
+
## 💙 Sponsored by Swiftproxy
<p align="center">
diff --git a/src/aliens_eye/cli.py b/src/aliens_eye/cli.py
index 4f0009f..85526cf 100644
--- a/src/aliens_eye/cli.py
+++ b/src/aliens_eye/cli.py
@@ -4,6 +4,7 @@ from __future__ import annotations
import asyncio
import json
+import os
import sys
from argparse import ArgumentParser
from pathlib import Path
@@ -31,6 +32,11 @@ from aliens_eye.utils.logger import setup_logger
TOR_PROXY = "socks5://127.0.0.1:9050"
+def _promo_enabled() -> bool:
+ """The line about the author's other project, unless ALIENS_EYE_NO_PROMO is set."""
+ return os.environ.get("ALIENS_EYE_NO_PROMO", "").strip().lower() not in {"1", "true", "yes", "on"}
+
+
def display_banner(site_count: int) -> None:
console = get_console()
banner = rf"""[yellow]
@@ -62,7 +68,13 @@ def display_banner(site_count: int) -> None:
[green]by [yellow]arxhr007 [dim]v{__version__}[/dim]"""
console.print(banner)
console.print("[yellow]AI-OSINT USERNAME SCANNER[/yellow]")
- console.print("[red]NOTE: For educational purposes only!\n[/red]")
+ console.print("[red]NOTE: For educational purposes only![/red]")
+ if _promo_enabled():
+ console.print(
+ "[dim]New from the author: lxask, a Linux command assistant that runs offline "
+ "-> https://github.com/arxhr007/lxask[/dim]"
+ )
+ console.print()
def build_parser() -> ArgumentParser:
diff --git a/tests/test_config_cli.py b/tests/test_config_cli.py
index 6afbf4f..f6822af 100644
--- a/tests/test_config_cli.py
+++ b/tests/test_config_cli.py
@@ -283,3 +283,56 @@ def test_accepting_an_expensive_level_keeps_it(monkeypatch):
monkeypatch.setattr(cli, "prompt_scan_level", lambda: "advanced")
monkeypatch.setattr(cli.Confirm, "ask", lambda *a, **k: True)
assert cli.choose_scan_level("someone", 854, console=None) == "advanced"
+
+
+# --- the author's other project, shown under the banner ---------------------------------
+
+
+def banner_text(monkeypatch, env=None):
+ import io
+
+ from rich.console import Console
+
+ from aliens_eye import cli
+
+ buffer = io.StringIO()
+ monkeypatch.setattr(cli, "get_console", lambda: Console(file=buffer, width=120, force_terminal=False))
+ monkeypatch.delenv("ALIENS_EYE_NO_PROMO", raising=False)
+ for key, value in (env or {}).items():
+ monkeypatch.setenv(key, value)
+ cli.display_banner(854)
+ return buffer.getvalue()
+
+
+def test_the_banner_mentions_the_authors_new_project(monkeypatch):
+ text = banner_text(monkeypatch)
+ assert "https://github.com/arxhr007/lxask" in text
+ assert "Aliens Eye" not in text.split("lxask")[0].splitlines()[-1] # one line, not woven into the art
+
+
+def test_the_mention_can_be_turned_off(monkeypatch):
+ for value in ("1", "true", "yes"):
+ assert "lxask" not in banner_text(monkeypatch, {"ALIENS_EYE_NO_PROMO": value})
+
+
+def test_an_empty_or_zero_setting_does_not_turn_it_off(monkeypatch):
+ for value in ("", "0", "false"):
+ assert "lxask" in banner_text(monkeypatch, {"ALIENS_EYE_NO_PROMO": value})
+
+
+def test_json_stdout_stays_clean():
+ """The banner is skipped for --json-stdout, so nothing but JSON reaches stdout."""
+ import inspect
+
+ from aliens_eye import cli
+
+ source = inspect.getsource(cli)
+ assert "if not config.json_stdout:\n display_banner(" in source
+
+
+def test_the_library_api_and_mcp_server_never_print_it():
+ import pathlib
+
+ root = pathlib.Path(__file__).resolve().parents[1] / "src" / "aliens_eye"
+ for name in ("api.py", "mcp_server.py"):
+ assert "lxask" not in (root / name).read_text("utf-8")