@portofcontext/pctx 0.1.4 → 0.2.0

package/CHANGELOG.md

@@ -5,24 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [UNRELEASED] - YYYY-MM-DD
+## [v0.2.0] - 2025-11-19
 
 ### Added
 
-
-### Fixed
-
+- `pctx dev` command with Terminal UI to explore CodeMode interface and track requests when running PCTX locally
+- `logger` configuration in `pctx.json` (`pctx_config::logger::LoggerConfig`) that supports configuring stdout logging level, format, and colorization
+- `telemetry` configuration in `pctx.json` (`pctx_config::telemetry::TelemetryConfig`) that supports enabling exporters for traces and metrics
+  - `examples/telemetry` example docker compose setup for Tempo/Prometheus/Grafana to try out these new configs
 
 ## [v0.1.4] - 2025-11-14
 
 ### Added
+
 - nasa mcp server example with scripts for running/deploying pctx
 
 ### Fixed
+
 - ts code ignore syncing
 - remove slow intel mac runner
 
-
 ## [v0.1.3] - 2025-11-13
 
 ### Added
@@ -66,7 +68,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial public release
 
-[Unreleased]: https://github.com/portofcontext/pctx/compare/v0.1.4...HEAD
+[Unreleased]: https://github.com/portofcontext/pctx/compare/v0.2.0...HEAD
+[v0.2.0]: https://github.com/portofcontext/pctx/compare/v0.2.0
 [v0.1.4]: https://github.com/portofcontext/pctx/compare/v0.1.4
 [v0.1.3]: https://github.com/portofcontext/pctx/compare/v0.1.3
 [v0.1.2]: https://github.com/portofcontext/pctx/compare/v0.1.2

package/README.md

@@ -22,10 +22,10 @@ The open source framework to connect AI agents to tools and services with [code
 # Homebrew
 brew install portofcontext/tap/pctx
 
-# Curl
+# cURL
 curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/portofcontext/pctx/main/install.sh | sh
 
-# NPM
+# npm
 npm i -g @portofcontext/pctx
 ```
 
@@ -39,13 +39,29 @@ pctx init
 pctx add my-local-server http://localhost:3000/mcp
 pctx add stripe https://mcp.stripe.com
 
-# Start the unified MCP server
-pctx start
+# Start the unified MCP server in dev mode
+pctx dev
 ```
 
 For complete CLI documentation, see [CLI.md](docs/CLI.md).
 For configuration options, see [Configuration Guide](docs/config.md).
 
+## Update
+
+Depending on the installation method (Homebrew/npm/cURL) the update method is different. Run `which pctx` if you are unsure what you used to install it.
+
+```bash
+# Homebrew update
+brew upgrade pctx
+
+# cURL update
+pctx-update
+
+# npm update
+npm upgrade -g @portofcontext/pctx
+
+```
+
 ## What is pctx?
 
 `pctx` sits between AI agents and MCP servers. It aggregates multiple upstream MCP servers, handles authentication, and exposes tools through a unified [Code Mode](#what-is-code-mode) interface. Instead of agents managing connections to individual MCP servers, they connect once to pctx.
@@ -75,7 +91,7 @@ console.log(`Found ${orders.length} orders`);
 
 - **Code Mode interface**: Tools exposed as TypeScript functions for efficient agent interaction. See [Code Mode Guide](docs/code-mode.md).
 - **Upstream MCP server aggregation**: Connect to multiple MCP servers through a single interface. See [Upstream MCP Servers Guide](docs/upstream-mcp-servers.md).
-- **Secure authentication**: OAuth, environment variables, system keychain, and external commands. See [Authentication Guide](docs/mcp-auth.md).
+- **Secure authentication**: Source secrets from environment variables, system keychain, and external commands. See [Authentication Section](docs/config.md#authentication) in the CLI configuration docs for more details.
 
 ## Architecture
 

package/npm-shrinkwrap.json

@@ -24,7 +24,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "@portofcontext/pctx",
-      "version": "0.1.4"
+      "version": "0.2.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -897,5 +897,5 @@
     }
   },
   "requires": true,
-  "version": "0.1.4"
+  "version": "0.2.0"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/portofcontext/pctx/releases/download/v0.1.4",
+  "artifactDownloadUrl": "https://github.com/portofcontext/pctx/releases/download/v0.2.0",
   "bin": {
     "generate-cli-docs": "run-generate-cli-docs.js",
     "pctx": "run-pctx.js"
@@ -68,7 +68,7 @@
       "zipExt": ".tar.gz"
     }
   },
-  "version": "0.1.4",
+  "version": "0.2.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"