fere-cli 0.3.1.dev33__tar.gz → 0.4.0.dev35__tar.gz

{fere_cli-0.3.1.dev33 → fere_cli-0.4.0.dev35}/.gitignore

@@ -8,6 +8,8 @@ __pycache__
 # Devcontainer local env (contains secrets)
 .devcontainer/.env.local
 .devcontainer/.env.local.override
+.devcontainer/.env.runtime.local
+.devcontainer/.env.runtime.*.local
 .devcontainer/.env.gitpod
 
 # Bruno gateway collection (GATEWAY_AGENT_ID / GATEWAY_PRIVATE_KEY_B64)
@@ -43,6 +45,7 @@ dev/logs/*
 # Cursor SEO skill — regenerated report JSON (not source)
 .cursor/skills/seo-agent/artifacts/
 .cursor/skills/docker-images-cve-scan/artifacts/
+docs/plans/artifacts/
 
 # Skills installed locally by the skills package manager (see skills-lock.json)
 .claude/skills/stripe-best-practices
@@ -52,6 +55,7 @@ dev/logs/*
 
 # agentmemory iii state (SQLite + streams under .agentmemory/data/)
 .agentmemory/data/
+.devcontainer/agentmemory-mcp/node_modules/
 
 # Local GEO upstream reference (optional clone; not part of the product tree)
 geo-seo/

{fere_cli-0.3.1.dev33 → fere_cli-0.4.0.dev35}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: fere-cli
-Version: 0.3.1.dev33
+Version: 0.4.0.dev35
 Summary: Terminal CLI for FereAI crypto trading and research
 Author-email: Fere AI <info@fere.ai>
 License-Expression: MIT
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1
-Requires-Dist: fere-sdk>=0.3.1.dev33
+Requires-Dist: fere-sdk>=0.4.0.dev35
 Requires-Dist: httpx>=0.27
 Requires-Dist: rich>=13.0
 Provides-Extra: dev

{fere_cli-0.3.1.dev33 → fere_cli-0.4.0.dev35}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "fere-cli"
-version = "0.3.1.dev33"
+version = "0.4.0.dev35"
 description = "Terminal CLI for FereAI crypto trading and research"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
 authors = [{ name = "Fere AI", email = "info@fere.ai" }]
 dependencies = [
-    "fere-sdk>=0.3.1.dev33",
+    "fere-sdk>=0.4.0.dev35",
     "httpx>=0.27",
     "click>=8.1",
     "rich>=13.0",

fere_cli-0.4.0.dev35/src/fere_cli/commands/perp.py

@@ -0,0 +1,337 @@
+"""Perp commands: fere perp (markets, status, setup, orders, open, close,
+cancel, fund, withdraw).
+
+Venue-neutral perpetual futures. ``size`` is in contracts.
+"""
+
+from __future__ import annotations
+
+import click
+from rich.console import Console
+
+from ..async_util import async_command, get_client, is_tty
+from ..output import print_error, print_success
+
+console = Console()
+
+
+@click.group()
+def perp():
+    """Trade perpetual futures (open, close, fund, withdraw)."""
+    pass
+
+
+@perp.command()
+@click.option("--search", default=None, help="Filter the asset universe.")
+@click.pass_context
+@async_command
+async def markets(ctx, search):
+    """List the tradable perp market universe."""
+    try:
+        client = await get_client(ctx)
+        data = await client.get_perp_markets(search_text=search)
+        await client.close()
+        print_success(data)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.pass_context
+@async_command
+async def status(ctx):
+    """Show whether perp trading is provisioned."""
+    try:
+        client = await get_client(ctx)
+        data = await client.get_perp_setup_status()
+        await client.close()
+        print_success(data)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.option("--force", is_flag=True, help="Re-run setup even if complete.")
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.pass_context
+@async_command
+async def setup(ctx, force, timeout):
+    """Provision perp trading for the account."""
+    try:
+        client = await get_client(ctx)
+        with console.status("Provisioning perp trading..."):
+            result = await client.perp_setup(force_rerun=force, timeout=timeout)
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.pass_context
+@async_command
+async def orders(ctx):
+    """List open perp orders (incl. TP/SL triggers)."""
+    try:
+        client = await get_client(ctx)
+        data = await client.get_perp_orders()
+        await client.close()
+        print_success(data)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.option("--asset", required=True, help="Asset symbol, e.g. BTC.")
+@click.option(
+    "--side",
+    required=True,
+    type=click.Choice(["long", "short"]),
+    help="Position direction.",
+)
+@click.option("--size", required=True, type=float, help="Size in contracts.")
+@click.option("--leverage", default=1, type=int, help="Leverage multiplier.")
+@click.option(
+    "--order-type",
+    default="market",
+    type=click.Choice(["market", "limit"]),
+)
+@click.option("--limit-price", default=None, type=float)
+@click.option("--slippage-pct", default=0.5, type=float)
+@click.option("--tp-price", default=None, type=float, help="Take-profit.")
+@click.option("--sl-price", default=None, type=float, help="Stop-loss.")
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation.")
+@click.pass_context
+@async_command
+async def open(
+    ctx,
+    asset,
+    side,
+    size,
+    leverage,
+    order_type,
+    limit_price,
+    slippage_pct,
+    tp_price,
+    sl_price,
+    timeout,
+    yes,
+):
+    """Open a perpetual position."""
+    if not yes and is_tty():
+        click.echo(f"Open {side} {size} {asset} at {leverage}x ({order_type})")
+        if not click.confirm("Proceed?"):
+            raise SystemExit(0)
+    try:
+        client = await get_client(ctx)
+        with console.status("Opening position..."):
+            result = await client.perp_open(
+                asset=asset,
+                is_buy=(side == "long"),
+                size=size,
+                leverage=leverage,
+                order_type=order_type,
+                limit_price=limit_price,
+                slippage_pct=slippage_pct,
+                tp_price=tp_price,
+                sl_price=sl_price,
+                timeout=timeout,
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.option("--asset", required=True, help="Asset symbol to close.")
+@click.option(
+    "--size",
+    default=None,
+    type=float,
+    help="Contracts to close; omit for full close.",
+)
+@click.option("--slippage-pct", default=0.5, type=float)
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation.")
+@click.pass_context
+@async_command
+async def close(ctx, asset, size, slippage_pct, timeout, yes):
+    """Close a perpetual position."""
+    if not yes and is_tty():
+        amt = f"{size}" if size is not None else "full"
+        click.echo(f"Close {amt} {asset} position")
+        if not click.confirm("Proceed?"):
+            raise SystemExit(0)
+    try:
+        client = await get_client(ctx)
+        with console.status("Closing position..."):
+            result = await client.perp_close(
+                asset=asset,
+                size=size,
+                slippage_pct=slippage_pct,
+                timeout=timeout,
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.option("--asset", required=True, help="Asset symbol of the order.")
+@click.option(
+    "--order-id", required=True, type=int, help="Venue order id (oid)."
+)
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.pass_context
+@async_command
+async def cancel(ctx, asset, order_id, timeout):
+    """Cancel an open perp order by its venue order id."""
+    try:
+        client = await get_client(ctx)
+        with console.status("Cancelling order..."):
+            result = await client.perp_cancel_order(
+                asset=asset, order_id=order_id, timeout=timeout
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.option(
+    "--amount",
+    required=True,
+    help="Source token amount in smallest units.",
+)
+@click.option(
+    "--source-chain-id", required=True, type=int, help="Source chain id."
+)
+@click.option(
+    "--source-token",
+    default=None,
+    help="ERC-20 address; omit for native token.",
+)
+@click.option(
+    "--usd",
+    "display_amount_usd",
+    default=None,
+    type=float,
+    help="USD amount the user entered.",
+)
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation.")
+@click.pass_context
+@async_command
+async def fund(
+    ctx,
+    amount,
+    source_chain_id,
+    source_token,
+    display_amount_usd,
+    timeout,
+    yes,
+):
+    """Fund the perp account from a connected wallet."""
+    if not yes and is_tty():
+        click.echo(f"Fund perp account from chain {source_chain_id}")
+        if not click.confirm("Proceed?"):
+            raise SystemExit(0)
+    try:
+        client = await get_client(ctx)
+        with console.status("Funding..."):
+            result = await client.perp_fund(
+                amount=amount,
+                source_chain_id=source_chain_id,
+                source_token=source_token,
+                display_amount_usd=display_amount_usd,
+                timeout=timeout,
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@perp.command()
+@click.option(
+    "--amount-usd", required=True, type=float, help="USD to withdraw."
+)
+@click.option(
+    "--destination-chain-id",
+    required=True,
+    type=int,
+    help="Destination chain id.",
+)
+@click.option(
+    "--destination-token",
+    default=None,
+    help="ERC-20/mint; omit for native token.",
+)
+@click.option(
+    "--timeout", default=120, type=int, help="Wait timeout (seconds)."
+)
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation.")
+@click.pass_context
+@async_command
+async def withdraw(
+    ctx, amount_usd, destination_chain_id, destination_token, timeout, yes
+):
+    """Withdraw perp collateral to a destination chain/token."""
+    if not yes and is_tty():
+        click.echo(f"Withdraw {amount_usd} USD to chain {destination_chain_id}")
+        if not click.confirm("Proceed?"):
+            raise SystemExit(0)
+    try:
+        client = await get_client(ctx)
+        with console.status("Withdrawing..."):
+            result = await client.perp_withdraw(
+                amount_usd=amount_usd,
+                destination_chain_id=destination_chain_id,
+                destination_token=destination_token,
+                timeout=timeout,
+            )
+        await client.close()
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)

{fere_cli-0.3.1.dev33 → fere_cli-0.4.0.dev35}/src/fere_cli/main.py

@@ -10,6 +10,7 @@ from .commands.chat import chat, threads
 from .commands.earn import earn
 from .commands.hooks import hooks
 from .commands.limit_order import limit_order
+from .commands.perp import perp
 from .commands.portfolio import holdings, notifications, wallets
 from .commands.swap import swap
 from .commands.utility import chains, config, status
@@ -90,6 +91,9 @@ cli.add_command(notifications)
 # Earn
 cli.add_command(earn)
 
+# Perp (venue-neutral perpetual futures)
+cli.add_command(perp)
+
 # Utility
 cli.add_command(chains)
 cli.add_command(status)