Skip to content

feat: add short-form lit:/// URLs, deprecate studio cp/ls/rm - #137

Merged
owbone merged 3 commits into
mainfrom
owbone/lit-urls
Aug 26, 2026
Merged

feat: add short-form lit:/// URLs, deprecate studio cp/ls/rm#137
owbone merged 3 commits into
mainfrom
owbone/lit-urls

Conversation

@owbone

@owbone owbone commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Allow lit:// URLs of the form lit:///<resource_type>/<path>, which infer the org and teamspace from the context.

lightning studio cp/ls/rm currently support an undocumented short-form URL of the form lit://<teamspace>/studios/<studio>/<path> or lit://<studio>/<path>. Rather than continuing to support those elsewhere, just mark those commands as deprecated in favour of plain cp/ls/rm with the new short-form URLs.

@dhedey dhedey left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My initial take - I\m not too sure on the clarity of lit:/// but would be OK supporting it.

Some alternatives:

  • lit-drive://
  • lit://drive/
  • lit://team/
  • lit://this-team/
  • lit://this-teamspace/
  • lit://teamspace/

Maybe on balance lit:/// is actually the best if we explain it clearly! :)

Also, is this a good time to replace <owner> with <organization> in all the docs? It was quite confusing what "owner" was when I read the docs today to show a client the CLI cp command.

Comment thread python/lightning_sdk/cli/cp/__init__.py Outdated
@owbone

owbone commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator Author

My initial take - I\m not too sure on the clarity of lit:/// but would be OK supporting it.

Some alternatives:

* `lit-drive://`

* `lit://drive/`

* `lit://team/`

* `lit://this-team/`

* `lit://this-teamspace/`

* `lit://teamspace/`

Maybe on balance lit:/// is actually the best if we explain it clearly! :)

Also, is this a good time to replace <owner> with <organization> in all the docs? It was quite confusing what "owner" was when I read the docs today to show a client the CLI cp command.

This is an established URL pattern to skip the authority, e.g. file:///, so it's well supported and easy to parse. They aren't necessarily drive specific and, unless we introduce a more magical syntax (e.g. lit://~/studios/...) (which would probably also be fine), then the other options are slightly ambiguous.

@owbone
owbone merged commit 8ab044f into main Aug 26, 2026
25 checks passed
@owbone
owbone deleted the owbone/lit-urls branch August 26, 2026 13:11
@dhedey

dhedey commented Aug 26, 2026

Copy link
Copy Markdown

This is an established URL pattern to skip the authority, e.g. file:///, so it's well supported and easy to parse

Nice, good point 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants