Repository navigation
Releases
pathiel 0.7.2: main keys refused for trading, partial closes
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 andstatesays "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 skipHYPERLIQUID_MASTER_PRIVATE_KEY, and everyclaude
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_positiontakesfraction(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_bracketenforces,
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
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 foraccount_overview, a tool 0.7.0 stopped listing; it now uses
get_account. - The README, the
pathiel-agentskill 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
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
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:
- pathiel makes a new API wallet key on your computer.
- A one-time local page opens. Your browser wallet (MetaMask, Rabby, OKX
and others) signs one approval, Hyperliquid'sapproveAgent. - 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
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:shareshows 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
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 theplugin
branch. - One less shell trick. The launcher no longer uses
evalto 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
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=testnetin
~/.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-mcpand a container
built fromDockerfile.mcprun the same public install outside Claude
Code. - A status check.
scripts/public_status.pyprints 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.jsonalready
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_refreshwrites a new
thesis through your localclaudecommand; 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.jsonruns the maintainer's mainnet config (20x, whole-equity
sizing). Use the plugin, the launcher or the container.