# Troubleshooting & how to **URL:** https://community.tuist.dev/c/troubleshooting-how-to/6.md [Latest](https://community.tuist.dev/latest.md) · [Categories](https://community.tuist.dev/categories.md) · [Tags](https://community.tuist.dev/tags.md) --- ## [About the Troubleshooting & how to category](https://community.tuist.dev/t/about-the-troubleshooting-how-to-category/15)
**Author:** [@pepicrft](https://community.tuist.dev/u/pepicrft)\ **Replies:** 0\ **Last updated:** [September 11, 2024, 4:19pm UTC](https://community.tuist.dev/t/about-the-troubleshooting-how-to-category/15 "2024-09-11T16:19:18Z")
Use this category to seek support from other community members. If you have questions about Tuist, ran into issues using it, or need some advise regarding how to do something with Tuist, use this category. --- ## [SwifterPM restore fails on git hosts that reject shallow fetches (buf.build) — no full-fetch fallback](https://community.tuist.dev/t/swifterpm-restore-fails-on-git-hosts-that-reject-shallow-fetches-buf-build-no-full-fetch-fallback/1016)
**Author:** [@kvyatkovskys](https://community.tuist.dev/u/kvyatkovskys)\ **Replies:** 0\ **Last updated:** [October 12, 2026, 5:52am UTC](https://community.tuist.dev/t/swifterpm-restore-fails-on-git-hosts-that-reject-shallow-fetches-buf-build-no-full-fetch-fallback/1016 "2026-10-12T05:52:14Z")
Cross-posting from GitHub as suggested by the triage bot: SwifterPM restore fails on git hosts that reject shallow fetches (buf.build): no full-fetch fallback · Issue #12647 · tuist/tuist · GitHub Summary tuist install … --- ## [Tuist edit make Xcode build manifest always successfull](https://community.tuist.dev/t/tuist-edit-make-xcode-build-manifest-always-successfull/1011)
**Author:** [@GiumaSoft](https://community.tuist.dev/u/GiumaSoft)\ **Replies:** 0\ **Last updated:** [September 4, 2026, 10:12am UTC](https://community.tuist.dev/t/tuist-edit-make-xcode-build-manifest-always-successfull/1011 "2026-09-04T10:12:02Z")
Question or problem I always intended “tuist edit” command to edit tuist manifest files via Xcode using syntax check and autocompletion. This is not anymore start from tuist@4.204.0 and later. Expectation “tuist edi… --- ## [Why can’t a Project scheme’s testAction reference test targets from another project?](https://community.tuist.dev/t/why-can-t-a-project-scheme-s-testaction-reference-test-targets-from-another-project/1005)
**Author:** [@Ernest0N](https://community.tuist.dev/u/Ernest0N)\ **Replies:** 0\ **Last updated:** [August 15, 2026, 9:15pm UTC](https://community.tuist.dev/t/why-can-t-a-project-scheme-s-testaction-reference-test-targets-from-another-project/1005 "2026-08-15T21:15:38Z")
Question or problem In a multi-project Tuist workspace, why can’t a Project scheme’s testAction reference unit-test targets that live in another project via TargetReference.project(path:target:), while the same cross-pro… --- ## [External binaryTarget dependency update fails to compile without Xcode Clean](https://community.tuist.dev/t/external-binarytarget-dependency-update-fails-to-compile-without-xcode-clean/991)
**Author:** [@ceichin-peya](https://community.tuist.dev/u/ceichin-peya)\ **Replies:** 2\ **Last updated:** [June 10, 2026, 8:46am UTC](https://community.tuist.dev/t/external-binarytarget-dependency-update-fails-to-compile-without-xcode-clean/991 "2026-06-10T08:46:16Z")
Steps to reproduce: 1. Run tuist init 2. In Tuist/Package.swift, add: .package(url: "https://github.com/getsentry/sentry-cocoa", exact: "9.16.1") 3. In Project.swift, add the dependency to the main target: dependenc… --- ## [Unable to use mise upgrade --bump to update Tuist CLI](https://community.tuist.dev/t/unable-to-use-mise-upgrade-bump-to-update-tuist-cli/982)
**Author:** [@nathan-sofia](https://community.tuist.dev/u/nathan-sofia)\ **Replies:** 7\ **Last updated:** [May 12, 2026, 3:41pm UTC](https://community.tuist.dev/t/unable-to-use-mise-upgrade-bump-to-update-tuist-cli/982 "2026-05-12T15:41:19Z")
Hello, I’m unsure if this is a problem with mise or a problem with Tuist or a problem with my setup, but every time I try to update Tuist CLI on my machine using \`mise upgrade --bump\` it fails with the following error: c… --- ## [PackageDescription.Context.environment crash when evaluating Package.swift](https://community.tuist.dev/t/packagedescription-context-environment-crash-when-evaluating-package-swift/980)
**Author:** [@Kyle-Ye](https://community.tuist.dev/u/Kyle-Ye)\ **Replies:** 0\ **Last updated:** [May 5, 2026, 12:44pm UTC](https://community.tuist.dev/t/packagedescription-context-environment-crash-when-evaluating-package-swift/980 "2026-05-05T12:44:22Z")
Question or problem Hi @pepicrft, I opened tuist/tuist#10616 and wanted to check whether this is behavior Tuist is expected to support. When Tuist evaluates a Package.swift, accessing PackageDescription.Context.environm… --- ## [I keep getting logged out from Tuist CLI](https://community.tuist.dev/t/i-keep-getting-logged-out-from-tuist-cli/978)
**Author:** [@nathan-sofia](https://community.tuist.dev/u/nathan-sofia)\ **Replies:** 1\ **Last updated:** [May 5, 2026, 7:27am UTC](https://community.tuist.dev/t/i-keep-getting-logged-out-from-tuist-cli/978 "2026-05-05T07:27:21Z")
I somehow keep getting logged out from Tuist CLI. I have the following warning multiple times a day, and it keeps coming back a few hours after I login: ! Warning The following items may need attention: ▸ Authenticat… --- ## [Tuist Preview, real devices](https://community.tuist.dev/t/tuist-preview-real-devices/948)
**Author:** [@kirilovep](https://community.tuist.dev/u/kirilovep)\ **Replies:** 3\ **Last updated:** [March 25, 2026, 4:04pm UTC](https://community.tuist.dev/t/tuist-preview-real-devices/948 "2026-03-25T16:04:33Z")
Hello, could you please let me know if Tuist Preview is currently working on real devices? I’ve spent a lot of time trying to install it, but the “Run” button doesn’t appear in the iOS app, and the admin panel shows the… --- ## [Provide the way to transform build settings and inject pre/post-build scripts for SwiftPM generated projects](https://community.tuist.dev/t/provide-the-way-to-transform-build-settings-and-inject-pre-post-build-scripts-for-swiftpm-generated-projects/949)
**Author:** [@edudnyk](https://community.tuist.dev/u/edudnyk)\ **Replies:** 0\ **Last updated:** [March 24, 2026, 4:35pm UTC](https://community.tuist.dev/t/provide-the-way-to-transform-build-settings-and-inject-pre-post-build-scripts-for-swiftpm-generated-projects/949 "2026-03-24T16:35:38Z")
Question or problem How can I apply default build settings, and / or inject pre/post-build script phases into targets generated from SwiftPM packages, WITHOUT THE NEED TO DECLARE configuration per target of the package? … --- ## [Tuist cache only simulator](https://community.tuist.dev/t/tuist-cache-only-simulator/916)
**Author:** [@makleso6](https://community.tuist.dev/u/makleso6)\ **Replies:** 2\ **Last updated:** [March 4, 2026, 11:50am UTC](https://community.tuist.dev/t/tuist-cache-only-simulator/916 "2026-03-04T11:50:10Z")
Is it possible to run tuist cache to cache only xcframework for is simulator --- ## [Missing resource accessors in static dependencies](https://community.tuist.dev/t/missing-resource-accessors-in-static-dependencies/918)
**Author:** [@czaplarski](https://community.tuist.dev/u/czaplarski)\ **Replies:** 6\ **Last updated:** [March 3, 2026, 8:51pm UTC](https://community.tuist.dev/t/missing-resource-accessors-in-static-dependencies/918 "2026-03-03T20:51:46Z")
Question or problem Hi :waving\_hand: we are currently evaluating Tuist for our app project and are close to the finish line, but after the rollback mentioned here, we are now blocked by static dependencies that rely on … --- ## [\`tuist inspect build\` misclassifies incremental builds as "clean" (Xcode 26 + cache)](https://community.tuist.dev/t/tuist-inspect-build-misclassifies-incremental-builds-as-clean-xcode-26-cache/920)
**Author:** [@nstfn](https://community.tuist.dev/u/nstfn)\ **Replies:** 1\ **Last updated:** [March 3, 2026, 9:01am UTC](https://community.tuist.dev/t/tuist-inspect-build-misclassifies-incremental-builds-as-clean-xcode-26-cache/920 "2026-03-03T09:01:54Z")
Question or problem Hey everyone :waving\_hand: After setting up Xcode Compilation Cache (Xcode 26), I’m running into a build categorization issue with tuist inspect build. Expectation Proper build categorization C… --- ## [Feedback from trying out Tuist Previews](https://community.tuist.dev/t/feedback-from-trying-out-tuist-previews/905)
**Author:** [@kaioelfke](https://community.tuist.dev/u/kaioelfke)\ **Replies:** 4\ **Last updated:** [March 2, 2026, 1:53pm UTC](https://community.tuist.dev/t/feedback-from-trying-out-tuist-previews/905 "2026-03-02T13:53:03Z")
I wanted to try tuist previews finally. Here’s some of the issues I ran into. AppNameMobile for the Debug configuration was not found. You can build it by running tuist build AppNameMobile Why does the output recommend… --- ## [Swift Package Registry overriding local dependency in Tuist-generated project](https://community.tuist.dev/t/swift-package-registry-overriding-local-dependency-in-tuist-generated-project/902)
**Author:** [@fdiaz](https://community.tuist.dev/u/fdiaz)\ **Replies:** 1\ **Last updated:** [February 19, 2026, 6:55pm UTC](https://community.tuist.dev/t/swift-package-registry-overriding-local-dependency-in-tuist-generated-project/902 "2026-02-19T18:55:30Z")
Swift Package Registry overriding local dependency in Tuist-generated project Hi folks — we’re running into an issue where a Swift Package Registry dependency appears to be taking precedence over a local package dependen… --- ## [The data couldn’t be read because it isn’t in the correct format](https://community.tuist.dev/t/the-data-couldn-t-be-read-because-it-isn-t-in-the-correct-format/876)
**Author:** [@Nonouf](https://community.tuist.dev/u/Nonouf)\ **Replies:** 2\ **Last updated:** [January 21, 2026, 1:25pm UTC](https://community.tuist.dev/t/the-data-couldn-t-be-read-because-it-isn-t-in-the-correct-format/876 "2026-01-21T13:25:48Z")
Question or problem I keep getting the following error message when I do mise x – tuist generate. ✖ Error The data couldn’t be read because it isn’t in the correct format. Sorry this didn’t work. Here’s what to tr… --- ## [How to provide build settings for build preAction](https://community.tuist.dev/t/how-to-provide-build-settings-for-build-preaction/874)
**Author:** [@kaserdan](https://community.tuist.dev/u/kaserdan)\ **Replies:** 0\ **Last updated:** [January 21, 2026, 8:49am UTC](https://community.tuist.dev/t/how-to-provide-build-settings-for-build-preaction/874 "2026-01-21T08:49:00Z")
Question or problem Is there any way to specify I want to provide build settings for build preAction? Scheme( name: "....", shared: true, buildAction: .buildAction( targets: \[....\], … --- ## [\`tuist run\` always fails](https://community.tuist.dev/t/tuist-run-always-fails/871)
**Author:** [@npckenjamin](https://community.tuist.dev/u/npckenjamin)\ **Replies:** 0\ **Last updated:** [January 19, 2026, 9:41pm UTC](https://community.tuist.dev/t/tuist-run-always-fails/871 "2026-01-19T21:41:13Z")
Question or problem tuist run always runs xcrun simctl boot twice. Once to install the app on the device and again before running it. The second always fails with Error: Unable to boot device in current state: Booted E… --- ## [How can a SPM package be used, ELI5?](https://community.tuist.dev/t/how-can-a-spm-package-be-used-eli5/858)
**Author:** [@CTMacUser](https://community.tuist.dev/u/CTMacUser)\ **Replies:** 2\ **Last updated:** [December 31, 2025, 2:52am UTC](https://community.tuist.dev/t/how-can-a-spm-package-be-used-eli5/858 "2025-12-31T02:52:50Z")
I tried to use a GitHub project for a Mac app. tuist install worked, but tuist generate got this error: :multiply: Error \`libetpan-swift\` is not a valid configured external dependency Sorry this didn’t work. Here’s w… --- ## [Tuist Cache CAS error in Github Actions](https://community.tuist.dev/t/tuist-cache-cas-error-in-github-actions/852)
**Author:** [@JanC](https://community.tuist.dev/u/JanC)\ **Replies:** 10\ **Last updated:** [December 25, 2025, 8:41pm UTC](https://community.tuist.dev/t/tuist-cache-cas-error-in-github-actions/852 "2025-12-25T20:41:03Z")
Hello there and Merry Christmas, I’m setting up a new side project and use the latest Tuist version 4.115.1 . I have an issue where the Github Action is stuck when running tuist test Warning: CAS error: deadlineExceed… --- ## [String Catalog Localization with Tuist](https://community.tuist.dev/t/string-catalog-localization-with-tuist/851)
**Author:** [@artemkrachulov](https://community.tuist.dev/u/artemkrachulov)\ **Replies:** 2\ **Last updated:** [December 24, 2025, 11:25am UTC](https://community.tuist.dev/t/string-catalog-localization-with-tuist/851 "2025-12-24T11:25:23Z")
Question or problem Does Tuist support localization via String Catalog (\`.xcstrings\`)? Context Tuist version: 4.115.1 I have a modular architecture with feature targets as static frameworks. Each feature has: Source… --- ## [Installing tuist with the "latest" tag and mise installs the macOS app instead of the CLI](https://community.tuist.dev/t/installing-tuist-with-the-latest-tag-and-mise-installs-the-macos-app-instead-of-the-cli/82)
**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\ **Replies:** 1\ **Last updated:** [December 22, 2025, 10:46am UTC](https://community.tuist.dev/t/installing-tuist-with-the-latest-tag-and-mise-installs-the-macos-app-instead-of-the-cli/82 "2025-12-22T10:46:20Z")
TLDR: If mise install tuist@latest installs the Tuist macOS app instead of the CLI, make sure that your mise plugins are up-to-date by running mise plugins update. --- ## [Need help with Tuist setup](https://community.tuist.dev/t/need-help-with-tuist-setup/845)
**Author:** [@iharandreyev](https://community.tuist.dev/u/iharandreyev)\ **Replies:** 3\ **Last updated:** [December 17, 2025, 9:12am UTC](https://community.tuist.dev/t/need-help-with-tuist-setup/845 "2025-12-17T09:12:23Z")
Question or problem When creating a new project with tuist init and adding ProjectDescriptionHelpers into Tuist directory (as per documentation), tuist fails to recognize it. Expectation tuist edit opens Manifests pr… --- ## [Transitive dependencies & Argus](https://community.tuist.dev/t/transitive-dependencies-argus/840)
**Author:** [@kaioelfke](https://community.tuist.dev/u/kaioelfke)\ **Replies:** 3\ **Last updated:** [December 16, 2025, 9:21am UTC](https://community.tuist.dev/t/transitive-dependencies-argus/840 "2025-12-16T09:21:04Z")
I’ve been trying out Argus after reading the blogpost by @pepicrft a bit yesterday and today. I can’t get \`argus trace graph\` to output dependencies. I get a list of all targets, but everything looks like this with an e… --- ## [SPM Dependency Causes System Header Parsing Errors in Tuist-Generated Xcode Project](https://community.tuist.dev/t/spm-dependency-causes-system-header-parsing-errors-in-tuist-generated-xcode-project/806)
**Author:** [@Alexandr-Ivantsov](https://community.tuist.dev/u/Alexandr-Ivantsov)\ **Replies:** 0\ **Last updated:** [October 30, 2025, 10:58am UTC](https://community.tuist.dev/t/spm-dependency-causes-system-header-parsing-errors-in-tuist-generated-xcode-project/806 "2025-10-30T10:58:59Z")
Question or problem I have an SPM package that compiles C code and includes it as a dependency in my iOS app via Tuist. When building with tuist build, I get compilation errors in system headers (dns\_sd.h and xpc/connect… --- ## [Best Practice for publish shared code with tuist](https://community.tuist.dev/t/best-practice-for-publish-shared-code-with-tuist/804)
**Author:** [@hanrw](https://community.tuist.dev/u/hanrw)\ **Replies:** 0\ **Last updated:** [October 26, 2025, 8:11am UTC](https://community.tuist.dev/t/best-practice-for-publish-shared-code-with-tuist/804 "2025-10-26T08:11:24Z")
Hi everyone, Is there anyone here who has used Tuist to create a framework, SDK, or library for reusable code? I currently have a project structured like the one below, and I want to extract some modules into an SPM li… --- ## [How to set project format to use Xcode version?](https://community.tuist.dev/t/how-to-set-project-format-to-use-xcode-version/785)
**Author:** [@hongbo-miao](https://community.tuist.dev/u/hongbo-miao)\ **Replies:** 3\ **Last updated:** [October 21, 2025, 9:30am UTC](https://community.tuist.dev/t/how-to-set-project-format-to-use-xcode-version/785 "2025-10-21T09:30:10Z")
Question Currently the generated iOS project is using Xcode 14.0. I am wondering how to set project format to use Xcode 16.3? Thank you! :smiley: Context Tuist version: 4.81.1 Reproduction (mandatory for problems) … --- ## [Product is cached but generate doesn't use it](https://community.tuist.dev/t/product-is-cached-but-generate-doesnt-use-it/781)
**Author:** [@ryanmeisters](https://community.tuist.dev/u/ryanmeisters)\ **Replies:** 3\ **Last updated:** [October 15, 2025, 10:38am UTC](https://community.tuist.dev/t/product-is-cached-but-generate-doesnt-use-it/781 "2025-10-15T10:38:07Z")
I have a very large modular project and I’m trying to optimize caching. Some cached modules don’t seem to be getting used when I generate the project. For example, I run tuist cache SomeModule , and the output looks li… --- ## [Add static library to "Link Binary With Libraries" section of static framework](https://community.tuist.dev/t/add-static-library-to-link-binary-with-libraries-section-of-static-framework/793)
**Author:** [@maveric94](https://community.tuist.dev/u/maveric94)\ **Replies:** 0\ **Last updated:** [October 13, 2025, 7:01pm UTC](https://community.tuist.dev/t/add-static-library-to-link-binary-with-libraries-section-of-static-framework/793 "2025-10-13T19:01:09Z")
Question or problem Hi! I have a project with several static library targets and one static framework target, that depends on libraries. I want static libraries to be in “Link Binary With Libraries“ section of static fra… --- ## [Tuist Fails to Link Custom Helper-Defined Schemes to Custom Configurations](https://community.tuist.dev/t/tuist-fails-to-link-custom-helper-defined-schemes-to-custom-configurations/777)
**Author:** [@swiftanon](https://community.tuist.dev/u/swiftanon)\ **Replies:** 0\ **Last updated:** [October 2, 2025, 11:46pm UTC](https://community.tuist.dev/t/tuist-fails-to-link-custom-helper-defined-schemes-to-custom-configurations/777 "2025-10-02T23:46:31Z")
Question or problem Hi everyone, I’ve run into a persistent issue with Tuist and wanted to check if anyone in the community has experienced something similar or has insights. I’ve already filed a bug report on Github. … [Next page](https://community.tuist.dev/c/troubleshooting-how-to/6.md?page=1)