Metadata-Version: 2.4
Name: clark-m
Version: 0.1.2
Summary: A personal, fully local cli Clark that can access Mac apps and more.
Author-email: Surjan <tsurjan506@gmail.com>
License-Expression: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.13.4
Requires-Dist: pydantic-settings>=2.14.2
Requires-Dist: pytest>=9.1.1
Requires-Dist: sentry-sdk>=2.35.0
Requires-Dist: setuptools>=83.0.0
Requires-Dist: typer>=0.27.0
Requires-Dist: ytmusicapi>=1.12.1
Dynamic: license-file

# Clark CLI

Clark CLI is a personal, fully local command-line assistant for macOS. It lets you control apps, search the web, play music, and manage simple system actions directly from your terminal.

This project is designed to feel like a second brain for everyday tasks on your Mac, without relying on any cloud service.

## What this project does

Clark CLI can help you perform these tasks:

- Open, close, hide, and unhide macOS applications
- Search the web using Safari
- Play songs from YouTube Music in your browser
- Adjust system volume and mute or unmute audio
- Clear recent menu items
- Put your Mac to sleep or lock the screen

## Features

- Fully local and terminal-based
- Works directly with macOS apps and system controls
- Built with Python and Typer
- Simple command-line interface for daily actions

## Installation

Make sure you have Python 3.11 or newer installed.

```bash
cd /path/to/CLI-agent
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```

## How to run

After installation, use the `clark` command:

```bash
clark --help
```

## Available commands

### App management commands

Open an app:

```bash
clark open "Visual Studio Code"
```

Close an app:

```bash
clark close "Google Chrome"
```

Hide an app:

```bash
clark hide "Safari"
```

Unhide an app:

```bash
clark unhide "Spotify"
```

### Browser commands

Search the web in Safari:

```bash
clark search --q "python tutorial"
```

Play a song from YouTube Music:

```bash
clark play "Shape of You"
```

### System settings commands

Set the system volume to 50:

```bash
clark sound 50
```

Mute system sound:

```bash
clark mute
```

Unmute system sound:

```bash
clark unmute
```

Clear recent menu entries:

```bash
clark clear menu
```

Put your Mac to sleep:

```bash
clark sleep
```

Lock your Mac screen:

```bash
clark lock
```

## Notes

This package is intended for macOS and uses system automation features, so it works best on a Mac machine.

Made With ❤️ by Surjan
