Metadata-Version: 2.5
Name: bevor-cli
Version: 0.1.1
Summary: Bevor CLI tool for security analysis and graph inspection
Classifier: Development Status :: 3 - Alpha
Requires-Python: >=3.13
Requires-Dist: bevor-sdk==0.1.1
Requires-Dist: click~=8.1
Requires-Dist: httpx~=0.28
Requires-Dist: packaging~=26.2
Requires-Dist: pydantic~=2.12
Requires-Dist: pyyaml~=6.0
Requires-Dist: questionary~=2.0
Requires-Dist: rich~=15.0
Requires-Dist: typer~=0.26
Description-Content-Type: text/markdown

# Bevor CLI

The official command-line interface for [Bevor](https://bevor.io) — smart contract security analysis and code graph exploration.

Use `bevor` to upload Solidity codebases, run security analyses, explore the code graph interactively, and manage findings — all from your terminal.

---

## Installation

```bash
curl -LsSf https://bevor.io/install.sh | bash
```

---

## Setup

```bash
bevor login
bevor link
#
bevor codes push
bevor analyses create
```

---

## Contents

`[]` -> optional args.
`<>` -> required args.

Simplification: EVERYTHING operates on the currently configured analysis. Findings as well.
Simplifies the DX, and we can take the stance that it's a rare state to want to operate on OTHER things via the CLI.
"version" is a flag that can be passed, but it's intentionally hard to act on arbitrary versions, unless the head is moved or the flag is passed.

### Local Configuration
- workspace [id]
- project [id]
- code [id, fingerprint]
- analysis [id]

```bash
help
login
logout
whoami [--json]
link
context [--json]
sessions
sessions list
sessions revoke <token_id>
workspaces
workspaces list [--json]
workspaces view [workspace_id] [--json]
workspaces select [workspace_id]
projects
projects list [--json]
projects view [project_id] [--json]
projects select [project_id]
projects create [--name] [--description] [--kind] [--yes]
codes
codes list [--page] [--page-size] [--order] [--order-by] [--project] [--network] [--identifier] [--status] [--json]
codes view [code_id] [--json]
codes select [code_id]
codes push [--path] [--no-wait] [--yes]
codes nodes
codes nodes list [--code] [--entrypoints] [--file] [--no-deps] [--name] [--node-type] [--json]
codes nodes view <node_id> [--code] [--json]
codes nodes content <node_id> [--code]
codes nodes edges <node_id> [--code] [--direction] [--type] [--json]
codes nodes call-chain <node_id> [--code] [--json]
codes nodes interactive <node_id> [--code]
analyses
analyses list [--page] [--page-size] [--order] [--order-by] [--project] [--user] [--is-owner] [--json]
analyses view [analysis_id] [--version] [--json]
analyses select [analysis_id] [--page] [--page-size]
analyses recent [--json]
analyses create [--name] [--collision] [--yes] [--json] [--force]
analyses set-head <version_id>
analyses run [--version] [--no-wait] [--silent]
analyses retry [--version] [--no-wait] [--silent]
analyses diff [--version] [--staged] [--json]
analyses commit [--version]
analyses child [--version] [--collision]
analyses fork [--version]
analyses merge <from_analysis> [--to]
analyses findings [--version] [--interactive] [--json] [--sarif]
analyses entrypoints [--version] [--json]
analyses transitions [--page] [--page-size] [--order] [--order-by] [--reason] [--version] [--project-wide] [--json]
analyses delete
analyses delete full
analyses delete version [version]
findings
findings list [--page] [--page-size] [--order] [--order-by] [--project] [--self] [--user] [--code] [--analyses] [--type] [--level] [--acknowledged] [--operation] [--created-by-self] [--created-by] [--json]
findings view <finding_id> [--json]
findings add [--version] [--file] [--interactive] [--type] [--level] [--name] [--explanation] [--recommendation] [--poc] [--tool] [--node] [--location] [--uri] [--start-line] [--start-column] [--end-line] [--end-column] [--char-offset] [--char-length] [--byte-offset] [--byte-length] [--fqn]
findings bulk <source> [--version]
findings edit <finding_id> [--file]
findings delete <finding_id>
findings revert <finding_id>
findings acknowledge <finding_id>
agent
agent setup
agent materialize
chats
chats list --page --page-size --order --order-by --project [--json]
chats view <chat_id> [--json]
chats messages <chat_id> [--json]
chats new <mode>
chats resume <chat_id>
```
