Skip to content

Open source AI coding agent. Designed for large projects and real world tasks.

more docs updates

Dane Schneider8c2187a46f9c
diff --git a/docs/docs/core-concepts/autonomy.md b/docs/docs/core-concepts/autonomy.md
index bbc5cb29..c817502e 100644
--- a/docs/docs/core-concepts/autonomy.md
+++ b/docs/docs/core-concepts/autonomy.md
@@ -1,91 +1,25 @@
---
sidebar_position: 2
-sidebar_label: Autonomy
+sidebar_label: Autonomy Levels
---
# Autonomy
Plandex v2 offers multiple levels of autonomy with pre-set config. Each autonomy level controls:
-- Automatic context loading and management
-- Automatic plan continuation
-- Automatic building of changes into pending updates
-- Automatic application of changes to project files
-- Automatic command execution and debugging
-- Automatic git commits after changes are applied successfully
-
-## Autonomy Levels
-
-### None
-
-Complete manual control with no automation:
-
-- Manual context loading
-- Manual plan continuation
-- Manual building of changes
-- Manual application of changes
-- Command execution disabled
-
-### Basic
-
-_Equivalent to Plandex v1 autonomy level_
-
-Minimal automation:
-
-- Manual context loading
-- Auto-continue plans until completion
-- Manual building of changes
-- Manual application of changes
-- Command execution disabled
-
-### Plus
-
-Smart context management and manual command execution:
-
-- Manual initial context loading
-- Auto-continue plans until completion
-- Smart context management (only loads necessary files during implementation steps)
-- Auto-update context when files change
-- Auto-build changes into pending updates
-- Manual application of changes
-- Manual command execution
-- Auto-commit changes to git when applied
-
-### Semi
-
-_Default autonomy level for a fresh Plandex install_
-
-Automatic context loading:
-
-- Auto-load context using project map
-- Auto-continue plans until completion
-- Smart context management
-- Auto-update context when files change
-- Auto-build changes into pending updates
-- Manual application of changes
-- Manual command execution
-- Auto-commit changes to git when applied
-
-### Full
-
-Complete automation:
-
-- Auto-load context using project map
-- Auto-continue plans until completion
-- Smart context management
-- Auto-update context when files change
-- Auto-build changes into pending updates
-- Auto-apply changes to project files
-- Auto-execute commands after successful apply
-- Auto-debug failing commands
-- Auto-commit changes to git when applied
+- Context loading and management
+- Plan continuation through multiple steps
+- Building of changes into pending updates
+- Application of changes to project files
+- Command execution and debugging
+- Git commits after changes are applied successfully
## Autonomy Matrix
| Feature | None | Basic | Plus | Semi | Full |
| --------------------- | ---- | ----- | ---- | ---- | ---- |
| `auto-continue` | ❌ | ✅ | ✅ | ✅ | ✅ |
-| `auto-build` | ❌ | ❌ | ✅ | ✅ | ✅ |
+| `auto-build` | ❌ | ✅ | ✅ | ✅ | ✅ |
| `auto-load-context` | ❌ | ❌ | ❌ | ✅ | ✅ |
| `smart-context` | ❌ | ❌ | ✅ | ✅ | ✅ |
| `auto-update-context` | ❌ | ❌ | ✅ | ✅ | ✅ |
@@ -141,9 +75,75 @@ plandex new --full # Create with 'Full'
\set-auto full # Set to Full-Auto
```
-### Custom Autonomy Config
+## Autonomy Levels
+
+### None
+
+Complete manual control with no automation:
+
+- Manual context loading
+- Context updates require approval
+- Manual plan continuation
+- Manual building of changes
+- Manually apply changes
+- Command execution disabled
+
+### Basic
+
+_Equivalent to Plandex v1 autonomy level_
+
+Minimal automation:
+
+- Manual context loading
+- Context updates require approval
+- Auto-continue plans until completion
+- Auto-build changes into pending updates
+- Manually apply changes
+- Command execution disabled
+
+### Plus
+
+Smart context management and manual command execution:
+
+- Manual context loading
+- Auto-update context when files change
+- Auto-continue plans until completion
+- Smart context management (only loads necessary files during implementation steps)
+- Auto-build changes into pending updates
+- Manually apply changes
+- Manual command execution
+- Auto-commit changes to git when applied
+
+### Semi
+
+_Default autonomy level for a fresh Plandex v2 install_
+
+Automatic context loading:
+
+- Auto-load context using project map
+- Auto-update context when files change
+- Auto-continue plans until completion
+- Smart context management
+- Auto-build changes into pending updates
+- Manually apply changes
+- Manual command execution
+- Auto-commit changes to git when applied
+
+### Full
+
+Complete automation:
+
+- Auto-load context using project map
+- Auto-continue plans until completion
+- Smart context management
+- Auto-update context when files change
+- Auto-build changes into pending updates
+- Auto-apply changes to project files
+- Auto-execute commands after successful apply
+- Auto-debug failing commands
+- Auto-commit changes to git when applied
-For more details on configuration options, see the [Configuration](./configuration.md) page.
+### Custom
You can give a plan custom autonomy settings by setting config values directly:
@@ -153,7 +153,7 @@ plandex set-config auto-build true
plandex set-config auto-load-context true
```
-For more details on configuration options, see the [Configuration](./configuration.md) page.
+[More details on configuration](./configuration.md)
## Safety
diff --git a/docs/docs/hosting/cloud.md b/docs/docs/hosting/cloud.md
index f4b59200..d5af117d 100644
--- a/docs/docs/hosting/cloud.md
+++ b/docs/docs/hosting/cloud.md
@@ -7,7 +7,7 @@ sidebar_label: Cloud
## Overview
-Plandex Cloud is the easiest and most reliable way to use Plandex. You'll be prompted to start a trial when you create your first plan with `plandex new`.
+Plandex Cloud is the easiest and most reliable way to use Plandex. You'll be prompted to start a trial when you launch the [REPL](../repl.md) with `plandex` or create your first plan with `plandex new`.
## Billing Modes
@@ -21,6 +21,9 @@ Plandex Cloud has two billing modes:
- Start with a $10 trial (includes $10 in credits).
- After the trial, you can upgrade to a paid plan for $45 per month—includes $20 in credits every month that never expire.
+[Get started with Integrated Models Mode.](https://app.plandex.ai/start?modelsMode=integrated)
+
+
### BYO API Key
- Use your own OpenAI, OpenRouter.ai, or other OpenAI-compatible provider accounts.
@@ -28,13 +31,15 @@ Plandex Cloud has two billing modes:
- Start with a free trial up to 10 plans and 20 model responses per plan.
- After the trial, you can upgrade to a paid plan for $30 per month.
+[Get started with BYO API Key Mode.](https://app.plandex.ai/start?modelsMode=byo)
+
## Billing Settings
-Run `plandex billing` in the terminal to bring up the billing settings page in your default browser, or go to [https://app.plandex.ai/settings/billing](https://app.plandex.ai/settings/billing) (sign in if necessary).
+Run `plandex billing` in the terminal to bring up the billing settings page in your default browser, or go to [your Billing Settings page](https://app.plandex.ai/settings/billing) (sign in if necessary).
-Here you can switch billing modes, view your current plan, manage your billing details, and pause or cancel your subscription.
+Here you can switch billing modes, view your current plan, manage your billing details, pause or cancel your subscription and more.
-## Integrated Models Mode
+### Integrated Models Mode
If you're using **Integrated Models Mode**, you can use the billing settings page to view your credits balance, purchase credits, and configure auto-recharge settings to automatically add credits to your account when your balance gets too low. You can also set a monthly budget and an email notification threshold.
@@ -44,7 +49,7 @@ You can see a full history of your usage that includes every model call and resp
## Privacy / Data Retention
-Data you send to Plandex Cloud is retained in order to debug and improve Plandex. In the future, this data may also be used to train and fine-tune models to improve performance.
+Data you send to Plandex Cloud is retained in order to debug and improve Plandex. In the future, this data may also be used to train and fine-tune models to improve performance and reduce costs.
That said, if you delete a plan or delete your Plandex Cloud account, all associated data will be removed. It will still be included in backups for up to 7 days, then it will no longer exist anywhere on Plandex Cloud.