junes 2.1.0

junes: the Jules CLI

junes

A command-line interface for the Jules REST API.

Installation

Use Case	Recommended Method
End Users	Quick Install (One-Liner) ⭐
Contributors	Manual Clone with uv
Without uv	Manual Clone with pip

Quick Install (One-Liner) ⭐

curl -sSL https://raw.githubusercontent.com/fanioz/junes/main/install.sh | bash

This will:

• Install uv if not present
• Clone the repository to ~/.junes/junes
• Set up a virtual environment
• Install the package
• Create the junes command in ~/.local/bin

Note: Make sure ~/.local/bin is in your PATH.

---

Alternative Installation Methods

Manual Clone with uv (Recommended for Development)

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone the repository
git clone https://github.com/fanioz/junes.git
cd junes

# Install in development mode
uv pip install -e .

# Or install with development dependencies
uv pip install -e ".[dev]"

# Create symlink to use globally
ln -sf "$(pwd)/junes-uv" ~/.local/bin/junes

Manual Clone with pip (Traditional)

# Clone the repository
git clone https://github.com/fanioz/junes.git
cd junes

# Install in development mode
pip install -e .

# Or install with development dependencies
pip install -e ".[dev]"

From PyPI

# Using uv
uv pip install junes

# Using pip
pip install junes

Note: The PyPI package is named junes, but the CLI command is junes. This naming avoids conflicts with existing PyPI packages.

Configuration

Initialize configuration

junes config init

This will create a configuration file at ~/.junes/config.toml and prompt for your API key.

API Key

The API key can be provided in three ways (in order of priority):

1. CLI option: junes --api-key YOUR_KEY sources list
2. Environment variable: Export JULES_API_KEY=YOUR_KEY
3. Config file: Set via junes config init

Usage

List sources

junes sources list
junes sources list --format json
junes sources list --format table

Create a session

junes sessions create <source-id>
junes sessions create <source-id> --format json

List sessions

junes sessions list
junes sessions list --status active

Get session details

junes sessions get <session-id>

Approve a plan

junes sessions approve <session-id>

List activities

junes activities list <session-id>

Send a message to the agent

junes agent send <session-id> "Your message here"
echo "Your message" | junes agent send <session-id>

Output Formats

All commands support three output formats:

• plain (default): Human-readable text output
• table: Tabular output using ASCII tables
• json: Machine-readable JSON output

Verbose Mode

Enable verbose logging to see HTTP request details:

junes --verbose sources list

Development

Run tests

Using uv (recommended):

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=junes --cov-report=html

# Run specific test file
uv run pytest tests/test_client.py

Using pytest directly:

# Run all tests
pytest

# Run with coverage
pytest --cov=junes --cov-report=html

# Run specific test file
pytest tests/test_client.py

Property-based testing

Property tests use Hypothesis and run with minimum 100 iterations by default.

Requirements

• Python 3.8 or higher

License

MIT