feat: init cli

Author: toanbku

.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - name: Format check
+        run: |
+          if [ -n "$(gofmt -l .)" ]; then
+            echo "Code is not formatted"
+            exit 1
+          fi
+
+      - name: Vet
+        run: go vet ./...
+
+      - name: Test
+        run: go test ./...
+
+  release:
+    needs: test
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - name: Verify tag is on main
+        run: |
+          git fetch origin main
+          if ! git merge-base --is-ancestor ${{ github.sha }} origin/main; then
+            echo "Tag must be on main branch"
+            exit 1
+          fi
+
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          version: "~> v2"
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - name: Format check
+        run: |
+          if [ -n "$(gofmt -l .)" ]; then
+            echo "Code is not formatted. Run 'make fmt'"
+            gofmt -d .
+            exit 1
+          fi
+
+      - name: Vet
+        run: go vet ./...
+
+      - name: Test
+        run: go test ./...
+
+      - name: Build
+        run: make build

.gitignore

@@ -0,0 +1,4 @@
+bin/
+dist/
+*.exe
+.DS_Store

.goreleaser.yaml

@@ -0,0 +1,46 @@
+version: 2
+
+builds:
+  - main: ./cmd/lpagent
+    binary: lpagent
+    env:
+      - CGO_ENABLED=0
+    flags:
+      - -trimpath
+    ldflags:
+      - -s -w
+      - -X github.com/lpagent/cli/internal/version.Version={{.Version}}
+      - -X github.com/lpagent/cli/internal/version.Commit={{.ShortCommit}}
+      - -X github.com/lpagent/cli/internal/version.Date={{.Date}}
+    goos:
+      - darwin
+      - linux
+      - windows
+    goarch:
+      - amd64
+      - arm64
+
+archives:
+  - format: tar.gz
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    format_overrides:
+      - goos: windows
+        format: zip
+
+checksum:
+  name_template: checksums.txt
+  algorithm: sha256
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^test:"
+      - "^ci:"
+
+release:
+  github:
+    owner: lpagent
+    name: cli
+  prerelease: auto

Makefile

@@ -0,0 +1,38 @@
+BINARY      := lpagent
+MODULE      := github.com/lpagent/cli
+VERSION_PKG := $(MODULE)/internal/version
+VERSION     := $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
+COMMIT      := $(shell git rev-parse --short HEAD 2>/dev/null || echo "none")
+DATE        := $(shell date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+LDFLAGS := -s -w \
+	-X $(VERSION_PKG).Version=$(VERSION) \
+	-X $(VERSION_PKG).Commit=$(COMMIT) \
+	-X $(VERSION_PKG).Date=$(DATE)
+
+.PHONY: build install test fmt vet lint clean
+
+build:
+	CGO_ENABLED=0 go build -trimpath -ldflags '$(LDFLAGS)' -o bin/$(BINARY) ./cmd/lpagent
+
+install:
+	CGO_ENABLED=0 go install -trimpath -ldflags '$(LDFLAGS)' ./cmd/lpagent
+
+test:
+	go test ./...
+
+fmt:
+	gofmt -w .
+
+vet:
+	go vet ./...
+
+lint: vet
+	@which golangci-lint >/dev/null 2>&1 || echo "Install golangci-lint: https://golangci-lint.run/usage/install/"
+	golangci-lint run ./...
+
+clean:
+	rm -rf bin/
+
+check: fmt vet test
+	@echo "All checks passed."

README.md

@@ -0,0 +1,176 @@
+# LP Agent CLI
+
+Command-line interface for the [LP Agent Open API](https://docs.lpagent.io). Manage Solana LP positions, discover pools, and generate add/remove liquidity transactions from the terminal.
+
+Single binary, no runtime dependencies. Works standalone or as a Claude agent skill.
+
+## Install
+
+### From release binaries
+
+Download the latest binary from [GitHub Releases](https://github.com/lpagent/cli/releases).
+
+```bash
+# macOS (Apple Silicon)
+curl -sL https://github.com/lpagent/cli/releases/latest/download/lp-agent-cli_darwin_arm64.tar.gz | tar xz
+sudo mv lpagent /usr/local/bin/
+
+# macOS (Intel)
+curl -sL https://github.com/lpagent/cli/releases/latest/download/lp-agent-cli_darwin_amd64.tar.gz | tar xz
+sudo mv lpagent /usr/local/bin/
+
+# Linux (amd64)
+curl -sL https://github.com/lpagent/cli/releases/latest/download/lp-agent-cli_linux_amd64.tar.gz | tar xz
+sudo mv lpagent /usr/local/bin/
+```
+
+### From source
+
+```bash
+go install github.com/lpagent/cli/cmd/lpagent@latest
+```
+
+### Build locally
+
+```bash
+git clone https://github.com/lpagent/cli.git
+cd lp-agent-cli
+make build
+./bin/lpagent --help
+```
+
+## Quick start
+
+```bash
+# 1. Set your API key (get one at https://app.lpagent.io)
+lpagent auth set-key
+
+# 2. Set a default wallet so you don't need --owner every time
+lpagent auth set-default-owner <wallet-address>
+
+# 3. View open positions
+lpagent positions open -o table
+
+# 4. View open positions in SOL
+lpagent positions open -o table --native
+
+# 5. Check portfolio overview
+lpagent positions overview -o table --native
+```
+
+## Commands
+
+### Auth
+
+```bash
+lpagent auth set-key                    # Set API key (saved to ~/.lpagent/config.json)
+lpagent auth status                     # Show current config
+lpagent auth set-default-owner <addr>   # Set default wallet
+```
+
+### Positions
+
+```bash
+lpagent positions open --owner <addr>                          # Open positions
+lpagent positions historical --owner <addr> --from 2025-01-01  # Closed positions
+lpagent positions overview --owner <addr>                      # Portfolio metrics
+lpagent positions logs --position <id>                         # Transaction logs
+lpagent positions get --position <id>                          # Position details
+lpagent positions revenue <addr>                               # Revenue data
+```
+
+### Pools
+
+```bash
+lpagent pools discover --chain SOL --sort-by tvl       # Discover pools
+lpagent pools info <poolId>                            # Pool details
+lpagent pools positions <poolId> --status Open         # Positions in a pool
+lpagent pools onchain-stats <poolId>                   # TVL, volume, fees
+lpagent pools top-lpers <poolId>                       # Top liquidity providers
+lpagent pools add-tx <poolId> --owner <addr> --strategy Spot --input-sol 1   # Zap-In tx
+lpagent pools landing-add-tx --file signed-tx.json     # Submit signed tx
+```
+
+### Token
+
+```bash
+lpagent token balance --owner <addr>                   # All token balances
+lpagent token balance --owner <addr> --ca <mint>       # Specific tokens
+```
+
+### Transactions (Zap-Out)
+
+```bash
+lpagent tx decrease-quotes --id <id> --bps 10000      # Get withdrawal quotes
+lpagent tx decrease-tx --position-id <id> --bps 10000 --owner <addr> --slippage-bps 500
+lpagent tx landing-decrease-tx --file signed-tx.json   # Submit signed tx
+```
+
+### Raw API
+
+```bash
+lpagent api get /lp-positions/opening --query "owner=<addr>"
+lpagent api post /position/decrease-quotes --data '{"id":"...","bps":5000}'
+```
+
+## Output formats
+
+All commands support `--output` / `-o`:
+
+| Format  | Description                        |
+|---------|------------------------------------|
+| `json`  | Full JSON response (default)       |
+| `table` | Human-readable table with colors   |
+| `quiet` | IDs only, one per line             |
+
+Use `--native` on `positions open` and `positions overview` to show values in SOL instead of USD.
+
+## Configuration
+
+Config stored at `~/.lpagent/config.json`:
+
+```json
+{
+  "api_key": "your-api-key",
+  "api_base_url": "https://api.lpagent.io/open-api/v1",
+  "default_owner": "your-wallet-address",
+  "output_format": "json"
+}
+```
+
+### Environment variables
+
+| Variable               | Description                    |
+|------------------------|--------------------------------|
+| `LPAGENT_API_KEY`      | API key (overrides config)     |
+| `LPAGENT_API_URL`      | Base URL (overrides config)    |
+| `LPAGENT_DEFAULT_OWNER`| Default wallet (overrides config) |
+
+CLI flags take highest priority, then env vars, then config file.
+
+## Development
+
+```bash
+make build      # Build binary to bin/lpagent
+make test       # Run tests
+make fmt        # Format code
+make vet        # Run go vet
+make lint       # Run golangci-lint
+make check      # All of the above
+make install    # Install to $GOPATH/bin
+```
+
+## Release
+
+Releases are automated via GitHub Actions + GoReleaser. To create a release:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+This triggers the release workflow which builds cross-platform binaries (darwin/linux/windows, amd64/arm64), creates a GitHub Release, and publishes checksums.
+
+## License
+
+MIT

cmd/lpagent/main.go

@@ -0,0 +1,7 @@
+package main
+
+import "github.com/lpagent/cli/internal/cli"
+
+func main() {
+	cli.Execute()
+}

go.mod

@@ -0,0 +1,10 @@
+module github.com/lpagent/cli
+
+go 1.26.1
+
+require github.com/spf13/cobra v1.10.2
+
+require (
+	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/spf13/pflag v1.0.9 // indirect
+)