Skip to main content

jama-agent

Remote Agent CLI for the Jama Security Platform — a unified cybersecurity platform with AI.

Install

pip install jama-agent

Quick Start

# 1. Login to your Jama server
jama-agent login --server https://your-jama-server.com --email you@company.com

# 2. Check connection status
jama-agent status

# 3. Connect via persistent WebSocket
jama-agent connect

# 4. Discover local network (from another terminal)
jama-agent discover

# 5. Disconnect
jama-agent disconnect

Commands

Command Description
login Authenticate against a Jama server
status Show current connection info
connect Establish persistent WebSocket connection
disconnect Clear credentials and disconnect
discover Discover hosts on the local network (ARP + ping sweep)
forward Port forwarding and SOCKS5 proxy via reverse tunnel
tunnels List active tunnels
version Show CLI version

Requirements

  • Python 3.10+
  • Access to a Jama Security Platform server

Network Discovery

# Auto-detect subnet and scan ARP table
jama-agent discover

# Specify subnet
jama-agent discover --subnet 192.168.1

# Full ping sweep (slower but thorough)
jama-agent discover --ping

SOCKS5 Tunnel

# Start a SOCKS5 proxy through the Jama tunnel
jama-agent forward --socks --socks-port 1080

# Then use with any tool:
export ALL_PROXY=socks5://127.0.0.1:1080
proxychains4 nmap -sV 10.0.0.0/24

Configuration

Config is stored in ~/.jama/:

  • config.yaml — Server URL, heartbeat interval, agent name
  • credentials.json — JWT tokens and agent ID (permissions 0600)

License

Proprietary - Jama Security Platform

Metadata

Release files for jama-agent 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jama-agent 0.5.0
File Size Uploaded Provenance
jama_agent-0.5.0.tar.gz 33.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for jama-agent 0.5.0
File Interpreter ABI Platform
jama_agent-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 63.5 kB

Release files / jama_agent-0.5.0.tar.gz

Download URL jama_agent-0.5.0.tar.gz
Size 33.3 kB
Tags Source
SHA-256 checksum
How to use checksums
ec2921cf37320634327dc724619f0b464b96d7ee9d08103ccac29e654c6b9fcf
BLAKE2b-256 checksum
How to use checksums
99bfbc54dedbdcee922972f432c468b82eaba72c19fe4d94e67568e97df32d56
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / jama_agent-0.5.0-py3-none-any.whl

Download URL jama_agent-0.5.0-py3-none-any.whl
Size 30.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
05b49434c3c0bbaf2e838baa91d68efebdf3db01aa357ad7b4e76dd34be52866
BLAKE2b-256 checksum
How to use checksums
c1494279577b0ea7e270d3e03832d82664bf7531d9d5eef8c3b1b5fd233d5e75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Security for jama-agent 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page