From 291f80a88dba5064ae0b5ed7163a215f1249b88f Mon Sep 17 00:00:00 2001
From: zaynelt <16801980+zaynelt@users.noreply.github.com>
Date: Fri, 26 Sep 2025 10:32:30 -0700
Subject: [PATCH 1/3] add missing line break

---
 docs/COMMAND_REFERENCE.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/COMMAND_REFERENCE.md b/docs/COMMAND_REFERENCE.md
index 130ee3c..94da824 100644
--- a/docs/COMMAND_REFERENCE.md
+++ b/docs/COMMAND_REFERENCE.md
@@ -117,7 +117,8 @@ workato connections get-oauth-url --id 789
 
 ## Environment Support
 
-**Trial Accounts:** Use `wrkatrial-` tokens with `https://app.trial.workato.com/api`
+**Trial Accounts:** Use `wrkatrial-` tokens with `https://app.trial.workato.com/api` 
+
 **Production Accounts:** Use `wrkprod-` tokens with `https://www.workato.com/api`
 
 ## Requirements

From 283c2e235d70e6b985c0ed3235a6e4aa7919a9ff Mon Sep 17 00:00:00 2001
From: zaynelt <16801980+zaynelt@users.noreply.github.com>
Date: Fri, 26 Sep 2025 11:58:18 -0700
Subject: [PATCH 2/3] Update main README

---
 README.md | 148 +++++++++++++++++++++++-------------------------------
 1 file changed, 63 insertions(+), 85 deletions(-)

diff --git a/README.md b/README.md
index 9275e00..1e533d7 100644
--- a/README.md
+++ b/README.md
@@ -15,128 +15,106 @@ A modern, type-safe command-line interface for the Workato API, designed for aut
 - **API Integration**: Manage API clients, collections, and endpoints
 - **AI Agent Support**: Built-in documentation and guide system
 
+# Quick Start Guide
+
+Get the Workato CLI running in 5 minutes.
+
+## Prerequisites
+
+- Python 3.11+
+- Workato account with API token
+
+### Getting Your API Token
+1. Log into your Workato account
+1. Navigate to **Workspace Admin** → **API clients**
+1. Click **Create API client**
+1. Fill out information about the client, click **Create client**
+1. Copy the generated token (starts with `wrkatrial-` for trial accounts or `wrkprod-` for production)
+
 ## Installation
 
-### From PyPI (Coming Soon)
+### Standard Installation
 ```bash
-pip install workato-platform-cli
+pip install -e .
+workato --version  # Verify installation
 ```
 
-### From Source
+### Alternative (if standard fails)
+If you get an "externally-managed-environment" error:
+
 ```bash
-git clone https://github.com/workato/workato-platform-cli.git
-cd workato-platform-cli
+# Virtual environment (recommended)
+python3 -m venv venv
+source venv/bin/activate  # Linux/Mac
 pip install -e .
 ```
 
-### For Development
+Having issues? See [DEVELOPER_GUIDE.md](/docs/DEVELOPER_GUIDE.md) for troubleshooting.
+
+## Setup
+
 ```bash
-# Install uv (recommended)
-curl -LsSf https://astral.sh/uv/install.sh | sh
+# Initialize CLI (will prompt for API token and region)
+workato init
 
-# Clone and setup
-git clone https://github.com/workato/workato-platform-cli.git
-cd workato-platform-cli
-make install-dev
+# Verify your workspace
+workato workspace
 ```
 
-## Quick Start
 
-```bash
-# Set up your profile and workspace
-workato init
-workato profiles create --name dev --region us
+## First Commands
 
+```bash
 # List available commands
 workato --help
 
-# Explore available connectors
-workato connectors list
-workato connectors parameters --provider salesforce
+# List your recipes
+workato recipes list
 
-# Manage connections
+# List your connections
 workato connections list
-workato connections create-oauth --provider salesforce
-
-# Manage recipes
-workato recipes list --folder-id 123
-workato recipes validate --project-id 456
-workato recipes start --recipe-id 789
-
-# Project operations
-workato push --project-id 123
-workato pull
 
-# AI agent access to structured documentation
-workato guide topics      # (for AI agents)
-workato guide search "oauth"  # (for AI agents)
+# Check project status
+workato workspace
 ```
 
-## For AI Agents & Developers
-
-This CLI is designed to enable AI agents to assist developers in building Workato assets:
-
-### **Recipe Development Workflow**
-1. **Validate Recipes**: `workato recipes validate` to check JSON syntax and structure
-2. **Create Connections**: `workato connections create` to set up OAuth authentication
-3. **Update Recipe Connections**: `workato recipes update-connection` to link recipes to connections
-4. **Deploy**: `workato push` to deploy recipes to Workato
-5. **Monitor**: `workato recipes jobs` to track execution
+## Next Steps
 
-### **AI Agent Capabilities**
-- **Recipe Validation**: Catch errors before deployment
-- **Connection Management**: Handle OAuth flows automatically
-- **Project Synchronization**: Keep local and remote in sync
-- **AI Documentation Interface**: `workato guide` provides structured knowledge for AI agents
-- **Error Diagnosis**: Detailed error messages and validation feedback
+- **Need detailed commands?** → See [COMMAND_REFERENCE.md](/docs/COMMAND_REFERENCE.md)
+- **Want real-world examples?** → See [USE_CASES.md](/docs/USE_CASES.md)
+- **Looking for sample recipes?** → See [examples/](/docs/examples/)
+- **Installation issues?** → See [DEVELOPER_GUIDE.md](/docs/DEVELOPER_GUIDE.md)
+- **Looking for all documentation?** → See [INDEX.md](/docs/INDEX.md)
 
-## Key Commands
 
-- `workato init` - Initialize CLI configuration and workspace
-- `workato profiles create/use` - Manage multiple environments
-- `workato recipes list/validate/start/stop` - Recipe lifecycle management
-- `workato connections create-oauth/list` - OAuth connection management
-- `workato connectors list/parameters` - Explore available connectors
-- `workato push/pull` - Sync projects with Workato workspace
-- `workato guide topics/search/content` - AI agent documentation interface
+## Quick Recipe Workflow
 
-## Use Cases
+```bash
+# 1. Validate a recipe file
+workato recipes validate --path ./my-recipe.json
 
-Perfect for:
-- **🤖 AI Agents**: Automated recipe validation, connection management, and troubleshooting assistance
-- **👨‍💻 Developers**: Local-first development with git integration and multi-environment support
-- **🏢 Teams**: CI/CD pipelines, bulk operations, and standardized workflows
-- **🔧 DevOps**: Infrastructure as code, automated deployments, and monitoring
+# 2. Push changes to Workato
+workato push
 
-> 📖 **See [resources/use-cases.md](resources/use-cases.md) for detailed scenarios and examples**
+# 3. Pull latest from remote
+workato pull
+```
 
-## Requirements
+You're ready to go!
 
-- **Python 3.11+** (type hints and modern async support)
-- **Workato API token** (from your Workato account settings)
-- **Valid Workato account** with API access
 
-## Development
+## Contributing to the CLI
 
-This project uses modern Python tooling for the best developer experience:
+If you want to contribute to the Workato CLI codebase itself, use these development commands:
 
+### Development Commands
 ```bash
-# Setup (with uv - recommended)
-make install-dev
-
-# Run all checks
-make check          # linting, formatting, type checking
-make test          # run tests
-make test-cov      # run tests with coverage
+python -m pytest      # Run tests
+flake8 src/workato_platform/   # Check code style
+```
 
-# Development workflow
-make format        # auto-format code
-make lint         # check code quality
-make build        # build distribution packages
+These commands are for CLI maintainers and contributors, not for developers using the CLI to build Workato integrations.
 
-# See all available commands
-make help
-```
 
 ### Tech Stack
 - **🐍 Python 3.11+** with full type annotations

From 87b022ccb3b0ead1d5193a2bc2feb33927ab611b Mon Sep 17 00:00:00 2001
From: Ossama Alami <ossama.alami@workato.com>
Date: Fri, 26 Sep 2025 12:33:52 -0700
Subject: [PATCH 3/3] Update README.md with new installation instructions

---
 README.md | 32 +++++++++++++++++++++++---------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 1e533d7..777eb26 100644
--- a/README.md
+++ b/README.md
@@ -33,13 +33,19 @@ Get the Workato CLI running in 5 minutes.
 
 ## Installation
 
-### Standard Installation
+### From PyPI (Coming Soon)
 ```bash
+pip install workato-platform-cli
+```
+
+### From Source
+```bash
+git clone https://github.com/workato/workato-platform-cli.git
+cd workato-platform-cli
 pip install -e .
-workato --version  # Verify installation
 ```
 
-### Alternative (if standard fails)
+### Alternative (if above fails)
 If you get an "externally-managed-environment" error:
 
 ```bash
@@ -105,16 +111,24 @@ You're ready to go!
 
 ## Contributing to the CLI
 
-If you want to contribute to the Workato CLI codebase itself, use these development commands:
+These commands are for CLI maintainers and contributors, not for developers using the CLI to build Workato integrations.
 
-### Development Commands
+### For Development
 ```bash
-python -m pytest      # Run tests
-flake8 src/workato_platform/   # Check code style
+# Setup (with uv - recommended)
+make install-dev
+
+# Run all checks
+make check          # linting, formatting, type checking
+make test          # run tests
+make test-cov      # run tests with coverage
+
+# Development workflow
+make format        # auto-format code
+make lint         # check code quality
+make build        # build distribution packages
 ```
 
-These commands are for CLI maintainers and contributors, not for developers using the CLI to build Workato integrations.
-
 
 ### Tech Stack
 - **🐍 Python 3.11+** with full type annotations