From 29d75d56ae33c2d1e34530d069741925a645a5e8 Mon Sep 17 00:00:00 2001 From: Zongqi Chen <137198879+zongqichen@users.noreply.github.com> Date: Thu, 24 Sep 2026 14:20:50 +0200 Subject: [PATCH] docs: refine target discovery terms --- .agents/skills/cfs/SKILL.md | 2 +- CHANGELOG.md | 4 ++-- README.md | 4 ++-- docs/comparison.md | 11 ++++++----- 4 files changed, 11 insertions(+), 10 deletions(-) diff --git a/.agents/skills/cfs/SKILL.md b/.agents/skills/cfs/SKILL.md index c5ec861..4311473 100644 --- a/.agents/skills/cfs/SKILL.md +++ b/.agents/skills/cfs/SKILL.md @@ -1,6 +1,6 @@ --- name: cfs -description: Safely select an existing cfs Cloud Foundry context and route CF CLI commands in cfs-managed workspaces, including parallel terminal or coding-agent workflows. Use for workspace-default or named-context selection, not for general Cloud Foundry deployment guidance. +description: Use cfs when parallel terminals, projects, Git worktrees, or coding agents need independent Cloud Foundry CLI sessions and targets without shared CF_HOME conflicts. Safely discover and select existing workspace-default or named contexts; not for general Cloud Foundry deployment guidance. --- # Use cfs contexts diff --git a/CHANGELOG.md b/CHANGELOG.md index e8a9979..7c8db94 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,8 +9,8 @@ contract may still change while cfs is pre-1.0. ### Changed -- Clarified multi-session discovery and documented how `cfs` differs from - manual `CF_HOME`, cf-targets-plugin, and cfctx workflows. +- Clarified multi-session and Agent Skill discovery, including how `cfs` + differs from manual `CF_HOME`, cf-targets-plugin, and cfctx workflows. ## [0.3.1] - 2026-09-24 diff --git a/README.md b/README.md index 6ad6702..bb11e0a 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,8 @@ [![Release](https://img.shields.io/github/v/release/zongqichen/cloud-foundry-cli-contexts?include_prereleases&sort=semver)](https://github.com/zongqichen/cloud-foundry-cli-contexts/releases) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) -Run multiple independent Cloud Foundry CLI sessions in parallel without shared -targets or `CF_HOME` collisions. +Run multiple Cloud Foundry CLI sessions and targets in parallel without +`CF_HOME` conflicts. The official `cf` CLI keeps its active API, organization, space, and authentication state in `$HOME/.cf`, so changing the target in one terminal diff --git a/docs/comparison.md b/docs/comparison.md index fd22fbe..4fe7744 100644 --- a/docs/comparison.md +++ b/docs/comparison.md @@ -1,9 +1,10 @@ -# Cloud Foundry CLI context options +# Cloud Foundry CLI contexts for multiple sessions and targets -The official Cloud Foundry CLI stores its active API, organization, space, and -authentication state under `CF_HOME`. Terminals that share the same `CF_HOME` -therefore share one current target. Several tools address this in different -ways. +Multiple Cloud Foundry CLI sessions can use different targets in parallel when +their mutable state is isolated. The official CLI stores its active API, +organization, space, and authentication state under `CF_HOME`. Terminals that +share the same `CF_HOME` therefore share one current target. Several tools +address this in different ways. | Approach | Isolation and selection | Keeps normal `cf` commands | Best fit | | --- | --- | --- | --- |