@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 03:37 UTC

next
mdx 89 lines 3.26 KB
Raw
1 ---
2 title: "CLI Improvements: Login, Link, and Whoami"
3 description: "Interactive org/project picker, --no-wait for link, and whoami no longer exposes API keys"
4 date: "2026-03-13"
5 ---
6
7 This release improves the Composio CLI with a better login flow, a non-blocking link option, and improved security for the whoami command.
8
9 ### CLI Version
10
11 | Package | Version |
12 |---------|---------|
13 | @composio/cli | v0.2.2 |
14
15 ---
16
17 ## What's New
18
19 ### Interactive Org/Project Picker After Login
20
21 `composio login` now prompts you to select your default organization and project after the browser OAuth flow completes.
22
23 - **Default behavior**: After login, you see an interactive picker to choose your org and project. If you have only one org and one project, they are auto-selected.
24 - **With `-y`**: Skip the picker and use the session defaults (e.g. for CI or scripts).
25
26 ```bash
27 composio login # Login, then pick org/project
28 composio login -y # Login, use session defaults (no picker)
29 composio login --no-browser # Print URL, don't open browser
30 ```
31
32 ### Non-Interactive Link with `--no-wait`
33
34 `composio link` now supports a `--no-wait` flag for non-blocking authorization flows.
35
36 - **Default**: Opens the browser and waits until the connected account is ACTIVE.
37 - **With `--no-wait`**: Prints link info and JSON to stdout (JQ-parseable) and exits immediately. Useful for scripts and CI.
38
39 ```bash
40 composio link github # Opens browser, waits for completion
41 composio link github --no-wait # Prints redirect URL and JSON, exits
42 ```
43
44 ### Whoami No Longer Exposes API Keys
45
46 The `composio whoami` command no longer displays API keys in the output. This improves security and reduces the risk of accidental exposure in logs or screenshots.
47
48 - API key is removed from both display and JSON output.
49 - Hints for `composio manage orgs switch` and `composio init` are shown instead.
50
51 ---
52
53 ## Breaking Changes
54
55 ### Removed Flags from Login and Init
56
57 The following flags have been removed from `composio login` and `composio init`:
58
59 - `--api-key`
60 - `--org-id`
61 - `--project-id`
62
63 <Callout type="warn">
64 **Breaking Change**
65
66 If you previously used `composio login --api-key uak_xxx --org-id X --project-id Y` for non-interactive login (e.g. in CI), you must use the browser-based flow instead. Use `composio login -y` to skip the org/project picker and accept session defaults.
67
68 For `composio init`, the `--org-id` and `--project-id` flags are removed. Use `composio init` interactively, or run `composio login` first and then `composio init`.
69 </Callout>
70
71 **Before:**
72 ```bash
73 composio login --api-key uak_xxx --org-id org_123 --project-id proj_456
74 composio init --org-id org_123 --project-id proj_456
75 ```
76
77 **After:**
78 ```bash
79 composio login -y # Login with session defaults (no picker)
80 composio init # Interactive project selection
81 ```
82
83 ---
84
85 ## Improvements
86
87 - **Login JSON output**: When using the org/project picker, the JSON output now reflects the final selection (not the initial session state).
88 - **Picker error handling**: If the org/project picker fails (e.g. API error), the CLI shows a warning, emits JSON with session data, and displays hints so you are not left without guidance.
89 - **Modularized org/project selection**: The selection logic is shared between `composio login` and `composio manage orgs switch`.