Skip to content

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

Show the lxask note as a bright gold box with a star (2.7.5)

arxhr0070beeddc4e959
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 082db13..20f5584 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
# Changelog
+## 2.7.5 (2026-10-25)
+
+### Changed
+- The note about [lxask](https://github.com/arxhr007/lxask) under the startup banner is now a
+ bright gold box with a star, and the link has its own line so a narrow terminal never splits
+ it. A console that cannot show emoji (an ASCII-only pipe, an old Windows console) gets an
+ asterisk instead of the star. `ALIENS_EYE_NO_PROMO=1` still hides it, and it is still never
+ printed with `--json-stdout`, by the library API or by the MCP server.
+
## 2.7.4 (2026-10-20)
### Fixed
diff --git a/README.md b/README.md
index d2c4fd2..aa43b47 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@
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`.
+To hide the gold box about it under the Aliens Eye banner, set `ALIENS_EYE_NO_PROMO=1`.
---
diff --git a/pyproject.toml b/pyproject.toml
index 9c95701..2480ef5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "aliens-eye"
-version = "2.7.4"
+version = "2.7.5"
description = "AI-powered OSINT username scanner across 800+ social media and web platforms"
readme = "README.md"
requires-python = ">=3.10"
diff --git a/src/aliens_eye/__init__.py b/src/aliens_eye/__init__.py
index 84793bd..129c0ac 100644
--- a/src/aliens_eye/__init__.py
+++ b/src/aliens_eye/__init__.py
@@ -1,3 +1,3 @@
"""Aliens Eye - AI-powered OSINT username scanner."""
-__version__ = "2.7.4"
+__version__ = "2.7.5"
diff --git a/src/aliens_eye/cli.py b/src/aliens_eye/cli.py
index d366b91..ff04c35 100644
--- a/src/aliens_eye/cli.py
+++ b/src/aliens_eye/cli.py
@@ -11,7 +11,10 @@ from pathlib import Path
from typing import Any
from platformdirs import user_config_dir
+from rich import box
+from rich.panel import Panel
from rich.prompt import Confirm, FloatPrompt, IntPrompt, Prompt
+from rich.text import Text
from aliens_eye import __version__
from aliens_eye.core.analyzer import FeatureExtractor
@@ -38,6 +41,32 @@ def _promo_enabled() -> bool:
return os.environ.get("ALIENS_EYE_NO_PROMO", "").strip().lower() not in {"1", "true", "yes", "on"}
+PROMO_GOLD = "bold #FFD700"
+PROMO_URL = "https://github.com/arxhr007/lxask"
+
+
+def _promo_panel(console) -> Panel:
+ """The note about the author's other project: a bright gold box with a star.
+
+ The link has its own line, so a narrow terminal never splits it. A console
+ that cannot show emoji (an ASCII-only pipe, an old Windows console) gets a
+ plain asterisk instead of an encoding error.
+ """
+ unicode_ok = str(getattr(console, "encoding", "") or "").lower().startswith("utf")
+ # Old Windows consoles (conhost without virtual terminal support) draw boxes
+ # but have no emoji glyphs, so they get an asterisk.
+ star = "⭐" if unicode_ok and not getattr(console, "legacy_windows", False) else "*"
+ text = Text(no_wrap=True)
+ text.append(f"{star} New from the author: lxask, a Linux command assistant that runs offline\n", PROMO_GOLD)
+ text.append(f" -> {PROMO_URL}", PROMO_GOLD)
+ return Panel.fit(
+ text,
+ box=box.ROUNDED, # rich draws an ASCII box itself where it must
+ border_style=PROMO_GOLD,
+ padding=(0, 1),
+ )
+
+
def display_banner(site_count: int) -> None:
console = get_console()
banner = rf"""[yellow]
@@ -71,10 +100,7 @@ def display_banner(site_count: int) -> None:
console.print("[yellow]AI-OSINT USERNAME SCANNER[/yellow]")
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(_promo_panel(console))
console.print()
diff --git a/tests/test_config_cli.py b/tests/test_config_cli.py
index f6822af..5b14521 100644
--- a/tests/test_config_cli.py
+++ b/tests/test_config_cli.py
@@ -296,7 +296,7 @@ def banner_text(monkeypatch, env=None):
from aliens_eye import cli
buffer = io.StringIO()
- monkeypatch.setattr(cli, "get_console", lambda: Console(file=buffer, width=120, force_terminal=False))
+ monkeypatch.setattr(cli, "get_console", lambda: Console(file=buffer, width=120, force_terminal=False, legacy_windows=False))
monkeypatch.delenv("ALIENS_EYE_NO_PROMO", raising=False)
for key, value in (env or {}).items():
monkeypatch.setenv(key, value)
@@ -306,8 +306,76 @@ def banner_text(monkeypatch, env=None):
def test_the_banner_mentions_the_authors_new_project(monkeypatch):
text = banner_text(monkeypatch)
+ assert "New from the author: lxask, a Linux command assistant that runs offline" in text
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 promo_lines(text):
+ lines = text.splitlines()
+ top = max(i for i, line in enumerate(lines) if line.lstrip().startswith("╭")) # rounded box corner
+ bottom = next(i for i in range(top, len(lines)) if lines[i].lstrip().startswith("╰"))
+ return lines[top:bottom + 1]
+
+
+def test_the_mention_is_in_a_box_with_a_star(monkeypatch):
+ box = promo_lines(banner_text(monkeypatch))
+ assert len(box) == 4 # top, the text, the link, bottom
+ assert "⭐" in box[1] and "lxask" in box[1]
+ assert "https://github.com/arxhr007/lxask" in box[2]
+ assert box[1].rstrip().endswith("│") and box[2].rstrip().endswith("│")
+
+
+def test_the_link_is_never_split_across_lines(monkeypatch):
+ """Copying or clicking a URL that wrapped mid-way does not work, so it has its own line."""
+ for width in (80, 100, 160):
+ import io
+
+ from rich.console import Console
+
+ from aliens_eye import cli
+
+ buffer = io.StringIO()
+ monkeypatch.setattr(cli, "get_console", lambda b=buffer, w=width: Console(file=b, width=w, force_terminal=False, legacy_windows=False))
+ monkeypatch.delenv("ALIENS_EYE_NO_PROMO", raising=False)
+ cli.display_banner(854)
+ assert any("https://github.com/arxhr007/lxask" in line for line in buffer.getvalue().splitlines()), width
+
+
+def test_the_box_is_bright_gold(monkeypatch):
+ 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=100, force_terminal=True, color_system="truecolor", legacy_windows=False))
+ monkeypatch.delenv("ALIENS_EYE_NO_PROMO", raising=False)
+ cli.display_banner(854)
+ gold = "38;2;255;215;0" # #FFD700
+ lines = [line for line in buffer.getvalue().splitlines() if "lxask" in line]
+ assert len(lines) == 2
+ for line in lines:
+ assert gold in line and "[1;" in line # gold, and bold for brightness
+ border = [line for line in buffer.getvalue().splitlines() if "╭" in line][-1]
+ assert gold in border
+
+
+def test_a_console_that_cannot_show_emoji_gets_a_plain_box():
+ import io
+
+ from rich.console import Console
+
+ from aliens_eye import cli
+
+ raw = io.BytesIO()
+ console = Console(file=io.TextIOWrapper(raw, encoding="ascii", errors="strict"), width=100,
+ force_terminal=False, legacy_windows=False)
+ console.print(cli._promo_panel(console))
+ console.file.flush()
+ text = raw.getvalue().decode("ascii") # would raise if anything non-ASCII were written
+ assert "lxask" in text and "*" in text
def test_the_mention_can_be_turned_off(monkeypatch):
@@ -336,3 +404,19 @@ def test_the_library_api_and_mcp_server_never_print_it():
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")
+
+
+def test_a_legacy_windows_console_gets_a_plain_star_but_still_a_box():
+ import io
+
+ from rich.console import Console
+
+ from aliens_eye import cli
+
+ buffer = io.StringIO()
+ console = Console(file=buffer, width=100, force_terminal=False, legacy_windows=True)
+ console.print(cli._promo_panel(console))
+ text = buffer.getvalue()
+ assert "⭐" not in text and "* New from the author" in text
+ assert "https://github.com/arxhr007/lxask" in text
+ assert text.splitlines()[0].strip() and text.splitlines()[-1].strip() # a top and a bottom edge