agent-work
Go-to-market automation toolkit that connects Google Workspace, LinkedIn (via Unipile), Attio CRM, ClearFeed, GitHub, and Notion into agent-driven workflows.
Built to be operated by coding agents (Claude Code, Codex, Gemini CLI, etc.) through natural-language recipes.
How it works
recipes/*.md Declarative workflow specs (what to do)
agent_work/integrations/ Python clients for each service (how to do it)
rules/*.md Per-service usage constraints (guardrails)
scripts/ Standalone utility scripts
An agent reads a recipe, calls the service clients, and writes the output to Google Sheets.
Services
| Client | Service | Transport |
|---|---|---|
GWS |
Google Workspace (Gmail, Calendar, Drive, Sheets) | gws CLI (subprocess) |
UnipileClient |
LinkedIn (messaging, posts, profiles) | REST API via httpx |
AttioClient |
Attio CRM (people, companies, deals, notes, tasks) | REST API via httpx |
ClearFeedClient |
ClearFeed (tickets, collections, customers) | REST API via httpx |
GitHubClient |
GitHub (repos, issues, PRs, commits, file contents) | REST API via httpx |
NotionClient |
Notion (databases, pages, search) | REST API via httpx |
All clients are synchronous and return raw dicts. Unipile, Attio, ClearFeed, GitHub, and Notion are context managers.
Rules
Per-service usage rules live in rules/. Each file documents constraints, required patterns, and approval requirements for its API. Agents should read the relevant rule file before calling a service.
Recipes
| Recipe | Description |
|---|---|
| LinkedIn Inbox Triage | Categorize LinkedIn messages, cross-reference CRM, suggest follow-ups |
| Calendar Meeting Prep | Prep briefs for upcoming meetings with CRM + LinkedIn context |
| CRM Pipeline Review | Pipeline snapshot — overdue tasks, recent notes, stale contacts |
| Email Inbox Summary | Gmail categorization with CRM cross-reference |
| Daily Report | Daily summary across Email, LinkedIn, ClearFeed, and Notion |
Run any recipe by telling your agent: Run recipes/<name>.md
Setup
uv sync # install dependencies
gws auth setup # authenticate Google Workspace CLI
cp .env.example .env # add your API keys
Environment variables
| Variable | Required | Service |
|---|---|---|
ATTIO_KEY |
yes | Attio CRM |
CLEARFEED_API_KEY |
yes | ClearFeed |
UNIPILE_DSN |
yes | Unipile |
UNIPILE_ACCESS_TOKEN |
yes | Unipile |
GITHUB_ACCESS_TOKEN |
yes | GitHub |
NOTION_API_KEY |
yes | Notion |
SUPABASE_URL |
no | Supabase |
SUPABASE_PASSWORD |
no | Supabase |
SUPABASE_KEY |
no | Supabase |
Quick start
# verify all services are connected
uv run python scripts/smoke.py
Agent compatibility
This repo includes instruction files for multiple coding agents:
| File | Agent |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
OpenAI Codex |
GEMINI.md |
Gemini CLI |
Each file contains the same project context tailored to the agent's expected format.
Metadata
Release files for agent-work 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_work-0.1.1.tar.gz | 21.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_work-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 33.5 kB
Release files / agent_work-0.1.1.tar.gz
| Download URL | agent_work-0.1.1.tar.gz |
|---|---|
| Size | 21.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e640118b38cdeebbbdae9eb0804e30db8e79692e2f42d21c4b3876eed97dd10b
|
|
BLAKE2b-256 checksum How to use checksums |
f8ebdb1efeae1084a2d9ae699830b19e5dd5f6fe172e0c64be3f2bb928348703
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / agent_work-0.1.1-py3-none-any.whl
| Download URL | agent_work-0.1.1-py3-none-any.whl |
|---|---|
| Size | 12.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d43115cf0ec900176edf45a484e605c2b4c1b9a84e9f5e48b5f355713ac501c3
|
|
BLAKE2b-256 checksum How to use checksums |
5e7e744c346bf29743988c09a6ec0926e3b4a6214521b142cce9e48aaf45f567
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|