Skip to content

Releases

pathiel 0.7.2: main keys refused for trading, partial closes

Choose a tag to compare

@Julian-dev28 Julian-dev28 released this 17 Nov 16:31
v0.7.2
f1e5d9a

pathiel 0.7.2

Released 2026-11-17. A security and fix release: the full list is in
CHANGELOG.md. pathiel stays free: no builder fee.

Security

  • A main account key is refused for trading. If the key you connect
    belongs to your main account (it can withdraw), the six live-money tools
    refuse and state says "Trading: BLOCKED". Use an API wallet key: it can
    trade and can never withdraw.
  • No pathiel process holds a key it does not need. The MCP server and
    the desk scripts skip HYPERLIQUID_MASTER_PRIVATE_KEY, and every claude
    process pathiel starts runs with no keys, tokens or passwords in its
    environment, so a prompt injection in a news headline finds nothing to
    steal.
  • Code scanning fixes: a crafted post can no longer stall the headline
    watch, and error answers no longer echo exception text.

New

  • Partial closes. close_position takes fraction (0.5 closes half).
    The stop and target stay on what is left.

Fixed

  • A stop set for the whole position in Hyperliquid's app now counts.
    Those orders carry size 0, so pathiel read the position as unprotected,
    and the desk tick closes an unprotected position.
  • Expired Polymarket markets stay out of the thesis. One still listed as
    open eight days after it ended woke the oil desk.
  • A new thesis must pay at least 2R, the floor place_bracket enforces,
    so a thesis can no longer pass and then be refused when you place it.

Update: claude plugin update pathiel@pathiel, then reconnect with /mcp.

Not financial advice. Leveraged perps can lose the whole account.

pathiel 0.7.1

Choose a tag to compare

@Julian-dev28 Julian-dev28 released this 14 Nov 05:47
bd7467d

pathiel 0.7.1

Released 2026-11-14. A fix release: the full list is in
CHANGELOG.md. pathiel stays free: no builder fee.

Security

  • msgpack 1.2.3 (GHSA-j586-36cw-2gc2). Plugin installs from 0.7.0 still
    pinned 1.2.2. Order signing is unchanged: the signing bytes of six real
    action shapes are identical on both versions, and a test now pins them.

Fixed

  • The desk-tick loop reads your balance again on a plugin install. It
    asked for account_overview, a tool 0.7.0 stopped listing; it now uses
    get_account.
  • The README, the pathiel-agent skill and the tools' own messages use the
    0.7.0 tool names and counts.

Fixes reach you sooner

A daily check now fails if a fix to anything the plugin ships waits on
main more than 7 days without a release (2 days for dependency pins), and
another fails on any dead link in the docs.

Not financial advice. Leveraged perps can lose the whole account.

pathiel 0.7.0

Choose a tag to compare

@Julian-dev28 Julian-dev28 released this 14 Nov 03:03
096762b

pathiel 0.7.0

Released 2026-11-13. The full list of changes is in
CHANGELOG.md. pathiel stays free: no builder fee.

30 tools instead of 65

A plugin install now lists 30 tools, one per job, every name a verb and a
noun: get_market for one coin, list_markets for many, get_account for
your money, get_positions, get_orders, get_history for your ledger,
size_trade before every place_bracket. Each description says when to use
the tool, which one to use instead, what it refuses and what it returns, so
Claude picks the right one the first time. In a live test a fresh Claude Code
session picked the intended tool for 7 of 7 plain questions.

Nothing was taken away. Every older tool name still answers when called.

Move a stop tighter: set_stop

set_stop {coin, stop_px} moves an open position's stop toward the price,
never away. The new stop goes on before the old one is cancelled, so the
position is never unprotected. A wider stop, or one past the price, is
refused and nothing is sent. Checked live on mainnet on a small gold
position.

Fixed

  • Fill history returned a wallet's oldest fills instead of its newest. It
    now keeps the newest, and a time window works for any wallet's fills.

For operators

PATHIEL_TOOLSET=v2 in .mcp.json's env lists the same toolset on your own
install (26 tools: wallet connect and the pool stay off there). Without it,
your install lists the same 60 tools as before, byte for byte.

Not financial advice. Leveraged perps can lose the whole account.

pathiel 0.6.0: connect your wallet with one signature

Choose a tag to compare

@Julian-dev28 Julian-dev28 released this 13 Nov 21:18
0c566c7

pathiel 0.6.0

Released 2026-11-13. The full list of changes is in
CHANGELOG.md. pathiel stays free: no builder fee.

Connect your Hyperliquid wallet with one signature

No more copying an API wallet key out of the Hyperliquid app. In Claude
Code, /pathiel:setup (or the new wallet_connect tool) does it for you:

  1. pathiel makes a new API wallet key on your computer.
  2. A one-time local page opens. Your browser wallet (MetaMask, Rabby, OKX
    and others) signs one approval, Hyperliquid's approveAgent.
  3. pathiel checks that Hyperliquid lists the new wallet, then saves the key
    to ~/.pathiel/.env.local (mode 600).

Your main key never leaves your wallet. The new key can trade and can never
withdraw. Hyperliquid lists it as pathiel-plugin, and keeps it approved
for 90 days: the result tells you the date, and connecting again before it
renews it. Pasting a key by hand still works.

Checked live on mainnet with OKX Wallet in Chrome. Other wallets and
browsers use the same standard (EIP-6963); if one fails, nothing is saved
and nothing is approved twice.

A website

https://julian-dev28.github.io/pathiel/ is a landing page for pathiel and
the research pool scoreboard.

Upgrading

claude plugin update pathiel@pathiel, or the Installed tab in
/plugin, then reconnect pathiel in /mcp. A key you already set keeps
working; wallet_connect never replaces it without asking.

pathiel 0.5.0: research pool, still free

Choose a tag to compare

@Julian-dev28 Julian-dev28 released this 13 Nov 20:13
8e5deae

pathiel 0.5.0

Released 2026-11-13. The full list of changes is in
CHANGELOG.md. pathiel stays free: no builder fee.

The research pool (opt-in)

Share your public Hyperliquid fills on the pool coins (xyz:BRENTOIL,
xyz:CL, xyz:SILVER, xyz:GOLD) and pathiel grades them with the same
fluke-or-edge harness the project runs on its own trades.

  • Join with one signed statement. /pathiel:share shows the exact text
    before anything is signed. The statement authorizes no trade, transfer,
    fee or payment, and the key is never printed or stored.
  • What you get: your own graded report through pool_report, and
    pool-level stats on which desks and setups hold up across members.
  • What is public: a scoreboard at least 24 hours late, never live, with
    only fills after your join. PRIVACY.md has the full list
    and how to leave.
  • What it is not: no payout, refund or reward tied to your returns, no
    copy-trading feed, and no edge is demonstrated by joining.

Four new tools on public installs: pool_status, pool_report,
pool_join, pool_leave (64 tools in total).

Upgrading

claude plugin update pathiel@pathiel, or the Installed tab in
/plugin, then reconnect pathiel in /mcp. Nothing changes until you
choose to join.

pathiel 0.4.1: free, no builder fee

Choose a tag to compare

@Julian-dev28 Julian-dev28 released this 13 Nov 19:54

pathiel 0.4.1

Released 2026-11-13. The full list of changes is in
CHANGELOG.md.

pathiel is free

The builder fee is waived. No order pathiel places carries a Hyperliquid
builder fee, so you pay only Hyperliquid's own trading fee, and there is
nothing to approve. /pathiel:setup no longer has an approval step.

If you approved the fee under 0.4.0, it is no longer charged. The approval
stays on Hyperliquid until you revoke it; how to do that is in
BUILDER_FEE.md. If pathiel ever charges a fee again, it
will ship as a new version with the rate in these notes.

Also in this release

  • A cleaner plugin listing. The Claude plugin directory now reviews a
    bundle that holds only what the plugin runs, published to the plugin
    branch.
  • One less shell trick. The launcher no longer uses eval to read your
    PATHIEL_HOME, so a path is always treated as text.

Upgrading

claude plugin update pathiel@pathiel, or the Installed tab in
/plugin, then reconnect pathiel in /mcp. Your keys, config and state in
~/.pathiel are untouched.

pathiel 0.4.0: public Claude Code plugin

Choose a tag to compare

@Julian-dev28 Julian-dev28 released this 13 Nov 01:41
v0.4.0
a5b4d8c

pathiel 0.4.0

Released 2026-11-12. The full list of changes is in
CHANGELOG.md.

What you get

  • A plugin a new user can install safely. Three lines in Claude Code
    (/plugin marketplace add Julian-dev28/pathiel,
    /plugin install pathiel@pathiel, /pathiel:setup), then a guided setup
    that shows the fee and the risks before any key is involved.
  • Safe default sizing. A fresh install starts at most 3x leverage, 1% of
    equity at risk per trade at the stop (up to 2% only when the venue minimum
    order forces it), one position at a time. Every order is still one
    bracket with an exact stop and target, refused under 2R.
  • Read-only without a key. Prices, candles, books, funding and the desk
    briefs all work on mainnet data with nothing configured.
  • Testnet when you ask for it. PATHIEL_NETWORK=testnet in
    ~/.pathiel/.env.local. On testnet the oil desk trades WTI (xyz:CL),
    because Brent is not listed there.
  • Other MCP clients. The launcher scripts/pathiel-mcp and a container
    built from Dockerfile.mcp run the same public install outside Claude
    Code.
  • A status check. scripts/public_status.py prints one PASS, WARN or
    FAIL line per setup item, with key names and never values.

Upgrading from 0.3.0

Update with claude plugin update pathiel@pathiel, or from the
Installed tab in /plugin. Third-party marketplaces do not auto-update
by default, so run it once yourself. Then reconnect pathiel in /mcp.

  • Network: nothing changes. 0.3.0 ran on mainnet and 0.4.0 still
    defaults to mainnet. Your mainnet state stays in ~/.pathiel/state.
  • Risk profile: check it. If ~/.pathiel/.agent-config.json already
    exists, setup does not overwrite it. Ask Claude for your risk limits
    (risk_limits) and lower them if they are above what you want. A missing
    or invalid profile falls back to the public default above.
  • Builder fee: your choice. Approve it to support the project, or
    don't. Nothing is charged until you approve, and every order works either
    way.

Builder fee disclosure

Rate 0.01% of notional per fill, 0.02% a round trip
In Hyperliquid's units f = 10 (tenths of a basis point)
Paid to 0x2c2e4efF574B3Fd9879AdeF9c5CAC6fD7C916985
When only after you approve it once with your master key
Without approval no fee; orders go out the same
Cap Hyperliquid rejects any order whose fee is above the rate you approved

On a 2,000 USD position the round trip costs 0.40 USD. To approve, run the
lines /pathiel:setup prints: a dry run first, then the signing line in
your own terminal, which asks for the master key at a hidden prompt. To stop
after approving, set PATHIEL_BUILDER_FEE_TENTHS_BP=0 in
~/.pathiel/.env.local and reconnect. Full details:
BUILDER_FEE.md.

Known limits

  • No demonstrated edge. The desk briefs are a written call with levels,
    not a forecast. No return is promised. This is not financial advice.
  • Restricted jurisdictions. Hyperliquid is not available to US persons
    or residents of other restricted regions. pathiel does not check where
    you are.
  • The daily loss figure is shown, not enforced. Nothing stops trading
    for the day after losses.
  • The network is read at start. After editing the env file, reconnect
    pathiel in /mcp. An approval signed on one network does not cover the
    other.
  • Builder fees on HIP-3 perps (xyz:BRENTOIL, xyz:GOLD) are unconfirmed.
    Hyperliquid's builder-code docs cover perps in general and never mention
    HIP-3 dexes. If the venue refuses the fee on such an order, pathiel sends it
    again without the fee, so the order still lands.
  • The first order after a cold start may carry no fee if the background
    approval read has not landed yet. Orders are never held for it.
  • The thesis needs the Claude Code CLI. desk_refresh writes a new
    thesis through your local claude command; without it, desk_refresh
    stops at once and says so.
  • The container is ghcr.io/julian-dev28/pathiel-mcp:0.4.0 (amd64 and
    arm64), listed in the official MCP registry as
    io.github.Julian-dev28/pathiel. It runs the same public launcher as the
    plugin.
  • A clone is not the public install. Opening a clone and accepting the
    repo .mcp.json runs the maintainer's mainnet config (20x, whole-equity
    sizing). Use the plugin, the launcher or the container.