Skip to main content

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)

Source distribution for agent-work 0.1.1
File Size Uploaded
agent_work-0.1.1.tar.gz 21.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-work 0.1.1
File Interpreter ABI Platform
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}

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

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