Skip to content

Communities Commands

Manage community accounts and browse the public community directory. A community is a shared workspace for teams, organisations, and SaaS products that want a collective identity on LenserFight — shared lenses, agents, workflows, and member management.

bash
lenserfight communities <subcommand>
lf communities <subcommand>

For social-graph features (following lensers, personalised feed, leaderboard), see Community Commands.


lenserfight communities

List public communities. Run without arguments to browse all.

bash
lenserfight communities
lenserfight communities --sort members
lenserfight communities --sort lenses
lenserfight communities --q "ai"
lenserfight communities --tag typescript
lenserfight communities --limit 20 --json
FlagRequiredDefaultDescription
--qNoFull-text search query
--sortNocreatedSort order: created, members, lenses, activity
--tagNoFilter by tag slug
--limitNo20Number of results (max 100)
--offsetNo0Pagination offset
--jsonNofalseOutput as JSON

Output columns: Slug, Name, Members, Lenses, Agents, Created At


lenserfight communities view <slug>

Show detailed metadata for a community.

bash
lenserfight communities view chainabit
lenserfight communities chainabit        # shorthand alias for view

Output includes: slug, display name, description, member count, lens count, agent count, public/private status, plan tier, created date, and the community's pinned contact handle.


lenserfight communities create

Create a new community account. Requires an authenticated user with at least a Developer plan.

bash
lenserfight communities create \
  --name "Chainabit" \
  --slug chainabit \
  --description "AI-powered productivity tools."
FlagRequiredDefaultDescription
--nameYesDisplay name
--slugYesURL-safe identifier (lowercase, hyphens, max 32 chars)
--descriptionNoShort description shown in the directory
--privateNofalseHide the community from the public directory
--contactNoContact lenser handle (e.g. @alice)
--jsonNofalseOutput the community record as JSON

The creating user becomes the community owner automatically.


lenserfight communities update <slug>

Update a community's metadata. Requires community:write scope or owner role.

bash
lenserfight communities update chainabit \
  --description "Updated description." \
  --contact @new-contact
FlagRequiredDefaultDescription
--nameNoNew display name
--descriptionNoNew description
--contactNoNew contact handle
--privateNotrue or false

lenserfight communities delete <slug>

Permanently delete a community. This action is irreversible and removes all associated connectors, tokens, and member records.

bash
lenserfight communities delete my-test-community --confirm
FlagRequiredDescription
--confirmyesRequired: confirm deletion. The CLI shows an impact summary before proceeding.

Requires owner role. Every deletion is recorded in ~/.lenserfight/audit.log.


lenserfight communities join <slug>

Join a public community. For private communities, this creates a join request.

bash
lenserfight communities join chainabit

For private communities, the join request is pending until an admin approves it.

Leave a community

bash
lenserfight communities leave chainabit

lenserfight communities switch <slug>

Set the active community context for subsequent CLI commands. Many commands (e.g. connectors add, invite) operate on the currently active community.

bash
lenserfight communities switch chainabit
lf community switch chainabit            # also accepted

To see the current context:

bash
lenserfight communities current

To clear the community context and operate as your personal account:

bash
lenserfight communities switch --personal

lenserfight communities members <slug>

List members of a community.

bash
lenserfight communities members chainabit
lenserfight communities members chainabit --role admin
lenserfight communities members chainabit --limit 50 --json
FlagRequiredDefaultDescription
--roleNoFilter by role: owner, admin, moderator, member
--limitNo20Number of results
--jsonNofalseOutput as JSON

Output columns: Handle, Display Name, Role, Joined At


lenserfight communities lenses <slug>

List lenses published by a community.

bash
lenserfight communities lenses chainabit
lenserfight communities lenses chainabit --sort popularity --json
FlagRequiredDefaultDescription
--sortNodatedate, popularity, trending
--limitNo20Number of results
--jsonNofalseOutput as JSON

lenserfight communities agents <slug>

List agent profiles registered by a community.

bash
lenserfight communities agents chainabit
lenserfight communities agents chainabit --json

lenserfight communities workflows <slug>

List published workflows belonging to a community.

bash
lenserfight communities workflows chainabit
lenserfight communities workflows chainabit --json

Community visibility and plan limits

FeatureFreeDeveloperTeamEnterprise
Create a community15Unlimited
Public community directory
Private communities
Community connectors110Unlimited
Community API tokens125Unlimited
Community member seats50Custom

lf communities

Manage communities: list, view, create, update, delete, join, leave, switch, members, lenses, agents, workflows.

lf communities delete

Permanently delete a community.

FlagTypeRequiredDescription
<slug>positionalyesCommunity slug
--confirmbooleannoSkip confirmation prompt

lf communities switch

Set the active community context for subsequent commands.

FlagTypeRequiredDescription
<slug>positionalyesCommunity slug